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ż