CHttpServerContext::TransmitFile

BOOL TransmitFile (uchwyt hFile, DWORD dwFlags = HSE_IO_DISCONNECT_AFTER_SEND, elementem LPVOID pstrHeader = NULL, DWORD dwHeaderLen = 0, elementem LPVOID pstrTrailer = NULL, DWORD dwTrailerLen = 0);

Wartość zwracany

Prawda , jeśli dane pliku została wysłana; w przeciwnym razie wartość FALSE. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError. Funkcja zwraca wartość FALSE , jeśli nakładające się operacja We/Wy nie jest zakończona przed TransmitFile zwraca. W takim przypadku Funkcja GetLastError zwraca ERROR_IO_PENDING.

Parametry

hFile

Dojście do pliku zawierającego dane, które przekazują. Plik musi został otwarty z FILE_FLAG_SEQUENTIAL_SCAN i FILE_FLAG_OVERLAPPED.

dwFlags

Atrybuty skojarzone z plikiem. Domyślnie HSE_IO_DISCONNECT_AFTER_SEND. Zobacz ServerSupportFunction w zestawie SDK platformy dla listy atrybutów możliwe.

pstrHeader

Wskaźnik ciąg znaków zawierający nagłówka do wysyłania przed przesłaniem pliku danych. Nagłówek przekazywanych do otrzymującego przeglądarki typu dane są wysyłane i w jaki sposób mają być wyświetlane. Jeśli wartość NULL, nagłówek nie są wysyłane.

dwHeaderLen

Długość nagłówka. Domyślnie 0. Jeśli pstrHeader nie ma wartości NULL, a dwHeaderLen jest równy 0, funkcja użyje funkcji Win32 lstrlen aby znaleźć długość przyczepy. (W tym przypadku pstrTrailer musi być ciągiem zakończonym znakiem null).

pstrTrailer

Wskaźnik ciąg znaków zawierający przyczepy wysłać po przesyłania pliku danych. Jeśli wartość NULL, przyczepy nie są wysyłane.

dwTrailerLen

Długość przyczepy. Domyślnie 0. Jeśli pstrTrailer nie ma wartości NULL, a dwTrailerLen jest równy 0, funkcja użyje funkcji Win32 lstrlen aby znaleźć długość przyczepy. (W tym przypadku pstrTrailer musi być ciągiem zakończonym znakiem null).

Uwagi

Wywołanie tej funkcji Państwa do przekazania pliku do żądającego. Ta funkcja Członkowskie wykonuje operacje Flaga polecenia ServerSupportFunction udostępnionej przez HSE_REQ_TRANSMIT_FILE. Serwer wykonuje tę operację asynchronicznie. Serwer przesyła tej operacji asynchronicznej kolejki I/O jej wewnętrznej i zwraca obiekt wywołujący. MFC zmienia obiekt kontekstu do zwrotu HSE_STATUS_PENDINGi będzie używał HSE_DONE_WITH_SESSION , gdy wywołanie zwrotne, wskazuje, że zakończenie MFC I/O. ustawia również m_bSendHeaders w obiekcie kontekście FAŁSZYWE, ponieważ nagłówki są wysyłane automatycznie.

Zobacz próbki PINBALL dla wykazania tej funkcji członek.

Omówienie CHttpServerContext |nbsp; Klasa członków | Wykres hierarchii

Zobacz też

CHttpServerContext::ServerSupportFunction

Index