CHttpServerContext::TransmitFile

BOOL TransmitFile (behandeln hFile, DWORD DwFlags = HSE_IO_DISCONNECT_AFTER_SEND, LPVOID PstrHeader = NULL, DWORD DwHeaderLen = 0, LPVOID PstrTrailer = NULL, DWORD DwTrailerLen = 0);

Rückgabewert

TRUE , wenn die Daten der Datei gesendet wurde; andernfalls FALSE. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError. Die Funktion gibt FALSE zurück, wenn eine overlapped i/O-Operation nicht abgeschlossen ist, bevor die TransmitFile zurückgibt. In diesem Fall zurückgibt GetLastError ERROR_IO_PENDING.

Parameter

hFile

Ein Handle für die Datei mit die Daten übertragen. Die Datei muss mit FILE_FLAG_SEQUENTIAL_SCAN und FILE_FLAG_OVERLAPPED geöffnet.

dwFlags

Die Attribute der Datei zugeordnet. In der Standardeinstellung HSE_IO_DISCONNECT_AFTER_SEND. Finden Sie unter ServerSupportFunction in der Platform SDK eine Liste der möglichen Attribute.

pstrHeader

Ein Zeiger auf die Zeichenfolge, die den Header zu senden, bevor die Daten der Datei übertragen. Der Header vermittelt an den empfangenden Browser den Typ der Daten, die gesendet werden und wie es angezeigt werden soll. Wenn nicht NULL, die Header gesendet wird.

dwHeaderLen

Die Länge des Headers. Standardmäßig 0. Wenn PstrHeader nicht NULList, und DwHeaderLen 0 ist, die Funktion verwendet die Win32-Funktion Lstrlen , die Länge des Anhängers zu finden. (In diesem Fall muss PstrTrailer eine Null-terminierte Zeichenfolge.)

pstrTrailer

Ein Zeiger auf die Zeichenfolge mit den Trailer zu senden, nachdem die Daten der Datei übertragen. Wenn nicht NULL, der Trailer gesendet wird.

dwTrailerLen

Die Länge des Anhängers. Standardmäßig 0. Wenn PstrTrailer nicht NULList, und DwTrailerLen 0 ist, wird die Funktion der Win32-Funktion Lstrlen verwenden, um die Länge des Anhängers zu finden. (In diesem Fall muss PstrTrailer eine Null-terminierte Zeichenfolge.)

Bemerkungen

Rufen Sie diese Memberfunktion um eine Datei an eine anfordernde Person zu übertragen. Dieser Member-Funktion führt die Operationen der HSE_REQ_TRANSMIT_FILE ServerSupportFunction Befehl Flagge. Der Server führt diesen Vorgang asynchron. Der Server sendet dieser Vorgang seine interne asynchrone Warteschlange mit I/O und an den Aufrufer zurückgibt. MFC verändert das Context-Objekt wieder HSE_STATUS_PENDINGund HSE_DONE_WITH_SESSION verwenden, wenn der Rückruf gibt an, dass Abschluss der e/a-MFC auch M_bSendHeaders im falschenKontextobjekt legt, da Header automatisch gesendet werden.

Finden Sie unter der PINBALL -Beispiel für eine Demonstration dieser Member-Funktion.

CHttpServerContext Übersicht |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch

CHttpServerContext::ServerSupportFunction

Index