CHttpServerContext::TransmitFile

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

Valor de retorno

TRUE se os dados do arquivo foi enviados; caso contrário, falso. Para informações de erro estendidas get, chamar GetLastError. A função retorna FALSE se uma operação de e/S sobreposta não está completa antes TransmitFile retorna. Nesse caso, GetLastError retorna ERROR_IO_PENDING.

Parâmetros

hFile

Um identificador para o arquivo que contém os dados a transmitir. O arquivo deve ter sido aberto com FILE_FLAG_SEQUENTIAL_SCAN e FILE_FLAG_OVERLAPPED.

dwFlags

Os atributos associados ao arquivo. Por padrão, HSE_IO_DISCONNECT_AFTER_SEND. Consulte ServerSupportFunction no Plataforma SDK para obter uma lista de atributos possíveis.

pstrHeader

Um ponteiro para o seqüência de caracteres que contém o cabeçalho para enviar antes de transmitir os dados do arquivo. O cabeçalho transmite para o navegador recebe o tipo de dados sendo enviados e como ele deve ser exibido. Se NULL, o cabeçalho não será enviado.

dwHeaderLen

O comprimento do cabeçalho. Por padrão, 0. Se pstrHeader não for NULL, e dwHeaderLen for 0, a função usará a função Win32 lstrlen para encontrar o comprimento do reboque. (Neste caso, pstrTrailer deve ser uma Cadeia de caracteres terminada por caractere nulo.)

pstrTrailer

Um ponteiro para o seqüência de caracteres que contém o reboque para enviar após a transmissão de dados do arquivo. Se NULL, o trailer não é enviado.

dwTrailerLen

O comprimento do reboque. Por padrão, 0. Se pstrTrailer não for NULL, e dwTrailerLen for 0, a função usará o de função de Win32 lstrlen para encontrar o comprimento do reboque. (Neste caso, pstrTrailer deve ser uma Cadeia de caracteres terminada por caractere nulo.)

Observações

Chame essa função de membro para transmitir um arquivo para um solicitante. Esta função de membro executa as operações da bandeira de comando ServerSupportFunction HSE_REQ_TRANSMIT_FILE. O servidor executa esta operação assincronamente. O servidor envia esta operação para sua fila de I/O assíncrona interna e retorna para o chamador. MFC altera o objeto de contexto para retornar HSE_STATUS_PENDINGe usará HSE_DONE_WITH_SESSION quando o retorno de chamada indica conclusão de e/S. MFC também define o m_bSendHeaders no objeto de contexto falso, porque cabeçalhos são enviados automaticamente.

Consulte o amostra PINBALL para uma demonstração desta função membro.

Visão geral de CHttpServerContext |nbsp; Membros de classe | Gráfico de hierarquia

Ver também

CHttpServerContext::ServerSupportFunction

Index