CHttpServerContext

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

Valore restituito

TRUE se i dati del file è stati inviati; in caso contrario, FALSE. Per ottenere informazioni di errore estese, chiamare GetLastError. La funzione restituisce FALSE se un'operazione sovrapposta I/O non è completa, prima che ritorni TransmitFile . In tal caso, GetLastError restituisce errore ERROR_IO_PENDING.

Parametri

hFile

Un handle per il file contenente i dati da trasmettere. Il file deve essere stato aperto con FILE_FLAG_SEQUENTIAL_SCAN e FILE_FLAG_OVERLAPPED.

dwFlags

Gli attributi associati al file. Per impostazione predefinita, HSE_IO_DISCONNECT_AFTER_SEND. Vedi ServerSupportFunction in Platform SDK per un elenco di possibili attributi.

pstrHeader

Puntatore a una stringa contenente l'intestazione per inviare prima di trasmettere i dati del file. L'intestazione trasmette al ricevente browser, il tipo di dati inviati e come deve essere visualizzato. Se NULL, l'intestazione non viene inviato.

dwHeaderLen

La lunghezza dell'intestazione. Per impostazione predefinita, 0. Se pstrHeader non è NULLe dwHeaderLen è 0, la funzione utilizza la funzione Win32 appartenenti per trovare la lunghezza del rimorchio. (In questo caso, pstrTrailer deve essere una stringa null-terminated.)

pstrTrailer

Puntatore a una stringa contenente il trailer di inviare dopo la trasmissione dei dati del file. Se NULL, il trailer non viene inviato.

dwTrailerLen

La lunghezza del rimorchio. Per impostazione predefinita, 0. Se pstrTrailer non è NULLe dwTrailerLen è 0, la funzione utilizza la funzione Win32 appartenenti per trovare la lunghezza del rimorchio. (In questo caso, pstrTrailer deve essere una stringa null-terminated.)

Osservazioni

Chiamare questa funzione membro a trasmettere un file da un richiedente. Questa funzione membro esegue le operazioni di bandiera comando ServerSupportFunction HSE_REQ_TRANSMIT_FILE. Il server esegue questa operazione in modo asincrono. Il server invia questa operazione alla relativa coda di I/O asincrona interna e restituisce al chiamante. MFC altera l'oggetto di contesto per restituire HSE_STATUS_PENDINGe utilizzerà HSE_DONE_WITH_SESSION quando il callback indica il completamento dei / O. MFC imposta anche m_bSendHeaders nell'oggetto contesto falsa, poiché le intestazioni vengono inviate automaticamente.

Vedi la esempio PINBALL per una dimostrazione di questa funzione membro.

CHttpServerContext panoramica |nbsp; Membri della classe | Gerarchia Chart

Vedi anche

CHttpServerContext::ServerSupportFunction

Index