CHttpServerContext::TransmitFile

BOOL TransmitFile (ОБРАБАТЫВАТЬ hFile, DWORD dwFlags = HSE_IO_DISCONNECT_AFTER_SEND, LPVOID pstrHeader = NULL, DWORD dwHeaderLen = 0, LPVOID pstrTrailer = NULL, DWORD dwTrailerLen = 0);

Возвращаемое значение

TRUE , если этот файл данных был направлен; в противном случае FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. Функция возвращает значение FALSE , если операции перекрывающегося ввода-вывода не завершена до TransmitFile возврата. В этом случае GetLastError возвращает ERROR_IO_PENDING.

Параметры

hFile

Дескриптор для файла, содержащего данные для передачи. Этот файл должен быть открыт с FILE_FLAG_SEQUENTIAL_SCAN и FILE_FLAG_OVERLAPPED.

dwFlags

Атрибуты, связанные с файлом. По умолчанию HSE_IO_DISCONNECT_AFTER_SEND. Посмотреть ServerSupportFunction в Platform SDK для получения списка возможных атрибутов.

pstrHeader

Указатель на строку, содержащую заголовок отправить до передачи данных файла. Заголовок передает в принимающем браузер тип отправляемых данных и как он должен отображаться. Если NULL, заголовок не отправлено.

dwHeaderLen

Длина заголовка. По умолчанию 0. Если pstrHeader не равно NULL, и dwHeaderLen равно 0, функция будет использовать функцию Win32 lstrlen найти длины прицепа. (В этом случае, pstrTrailer должен быть значением null строку).

pstrTrailer

Указатель на строку, содержащую прицеп для отправки после передачи данных файла. Если NULL, прицеп не отправлено.

dwTrailerLen

Длина прицепа. По умолчанию 0. Если pstrTrailer не равно NULL, и dwTrailerLen равно 0, функция будет использовать функцию Win32 lstrlen чтобы найти длины прицепа. (В этом случае, pstrTrailer должен быть значением null строку).

Примечания

Вызов этой функции-члена для передачи файла инициатор запроса. Эта функция-член выполняет операции флаг команды ServerSupportFunction HSE_REQ_TRANSMIT_FILE. Сервер выполняет эту операцию асинхронно. Сервер отправляет эту операцию в его внутреннюю очередь асинхронного ввода-вывода и возвращается вызывающему объекту. MFC изменяет объект контекста для возврата HSE_STATUS_PENDINGи будет использовать HSE_DONE_WITH_SESSION когда обратного вызова указывает, что завершение MFC I/O. также устанавливает m_bSendHeaders в объекте контекста Ложь, потому что автоматически отправляются заголовки.

Посмотреть ПИНБОЛ образец для демонстрации этой функции-члена.

Обзор CHttpServerContext |nbsp; Члены класса | Иерархическая схема

Родственные слова

CHttpServerContext::ServerSupportFunction

Index