CHttpServerContext::TransmitFile

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

Valor devuelto

TRUE si los datos del archivo fue enviados; en caso contrario, FALSE. Para obtener información de error ampliada, llame a GetLastError. La función devuelve FALSE si no se completa una operación de E/s superpuesta antes TransmitFile devuelve. En ese caso, GetLastError devuelve ERROR_IO_PENDING.

Parámetros

hFile

Identificador del archivo que contiene los datos a transmitir. El archivo debe abrir con FILE_FLAG_SEQUENTIAL_SCAN y FILE_FLAG_OVERLAPPED.

dwFlags

Los atributos asociados con el archivo. De forma predeterminada, HSE_IO_DISCONNECT_AFTER_SEND. Ver ServerSupportFunction en el SDK de la plataforma para obtener una lista de atributos posibles.

pstrHeader

Un puntero a la cadena que contiene el encabezado de enviar antes de transmitir los datos del archivo. El encabezado transmite al receptor navegador el tipo de datos que se envían y cómo debe mostrarse. Si NULL, el encabezado no enviado.

dwHeaderLen

La longitud del encabezado. Por defecto, 0. Si pstrHeader no es NULLy dwHeaderLen es 0, la función utilizará la función Win32 lstrlen para encontrar la longitud del remolque. (En este caso, pstrTrailer debe ser una cadena terminada en nulo.)

pstrTrailer

Un puntero a la cadena que contiene el trailer para enviar después de transmitir los datos del archivo. Si nula, el tráiler no enviado.

dwTrailerLen

La longitud del remolque. Por defecto, 0. Si pstrTrailer no es NULLy dwTrailerLen es 0, la función utilizará la función de Win32 lstrlen para encontrar la longitud del remolque. (En este caso, pstrTrailer debe ser una cadena terminada en nulo.)

Observaciones

Llamar a esta función miembro para transmitir un archivo a un solicitante. Esta función miembro realiza las operaciones de la bandera de comando de ServerSupportFunction HSE_REQ_TRANSMIT_FILE. El servidor realiza esta operación asincrónica. El servidor envía esta operación a su cola de I/O asincrónica interna y devuelve al llamador. MFC altera el objeto de contexto para volver a HSE_STATUS_PENDINGy utilizará HSE_DONE_WITH_SESSION cuando la devolución de llamada indica finalización de MFC I/O. también establece m_bSendHeaders en el objeto de contexto falso, porque se envían automáticamente encabezados.

Consulte la muestra PINBALL para una demostración de esta función miembro.

Visión General de CHttpServerContext |nbsp; Miembros de clase | Diagrama de jerarquía

Véase también

CHttpServerContext::ServerSupportFunction

Index