CHttpServerContext::TransmitFile

BOOL TransmitFile (ВПОРАТИСЯ з hFile, DWORD dwFlags = HSE_IO_DISCONNECT_AFTER_SEND, LPVOID pstrHeader = NULL, DWORD dwHeaderLen = 0, LPVOID pstrTrailer = NULL, DWORD dwTrailerLen = 0);

Значення, яке повертається

Правда , якщо надіслано до файлу даних; в іншому випадку, ПОМИЛКОВІ. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError. Функція повертає брехня , якщо перекриваються операції вводу-виводу не буде повним, перш ніж TransmitFile повертається. У цьому випадку GetLastError повертає ERROR_IO_PENDING.

Параметри

hFile

Дескриптор файлу, який містить дані для передачі. Файл має відкриті з FILE_FLAG_SEQUENTIAL_SCAN і FILE_FLAG_OVERLAPPED.

dwFlags

Атрибути, пов'язані з файлом. За замовчуванням, HSE_IO_DISCONNECT_AFTER_SEND. Див ServerSupportFunction в Платформа SDK список можливих атрибути.

pstrHeader

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

dwHeaderLen

Довжина заголовку. За замовчуванням 0. Якщо pstrHeader не NULL, і dwHeaderLen 0, функція буде використовувати функцію Win32 lstrlen знайти довжина причепом. (У цьому випадку, pstrTrailer повинні бути нульовим закінченням.)

pstrTrailer

Вказівник на рядок, що містить трейлер до надсилання після передавання файлу даних. Якщо значення NULL, Причіп не надсилаються.

dwTrailerLen

Довжина причепом. За замовчуванням 0. Якщо pstrTrailer не є NULL, і dwTrailerLen є 0, функція буде використовувати Win32 функції lstrlen знайти довжина причепом. (У цьому випадку, pstrTrailer повинні бути нульовим закінченням.)

Зауваження

Телефонуйте цієї функції-члена передати файл до до замовника. Ця функція-член виконує операції прапор команди ServerSupportFunction HSE_REQ_TRANSMIT_FILE. Сервера асинхронно виконує цю операцію. Сервер надсилає цю операцію до її внутрішніх асинхронних черги I/O і повертається до абонента. MFC змінює об'єкт контексту для повернення HSE_STATUS_PENDINGі буде використовувати HSE_DONE_WITH_SESSION , коли зворотного вказує, що завершення I/O. MFC також встановлює m_bSendHeaders в контексті об'єкт ПОМИЛКОВИМ, тому що заголовки надіслані автоматично.

Побачити на PINBALL зразок для демонстрації цієї функції-члени.

Огляд CHttpServerContext |nbsp; Члени класу | Ієрархічна діаграма

Дивіться також

CHttpServerContext::ServerSupportFunction

Index