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