BOOL TransmitFile (gérer hFile, DWORD dwFlags = HSE_IO_DISCONNECT_AFTER_SEND, LPVOID pstrHeader = NULL, DWORD dwHeaderLen = 0, LPVOID pstrTrailer = NULL, DWORD dwTrailerLen = 0);
Valeur de retour
TRUE si les données du fichier a été envoyées ; sinon, FALSE. Pour obtenir étendue des informations d'erreur, appelez GetLastError. La fonction retourne FALSE si une opération d'e/S avec chevauchement n'est pas complete avant TransmitFile renvoie. Dans ce cas, GetLastError retourne ERROR_IO_PENDING.
Paramètres
hFile
Un handle vers le fichier contenant les données à transmettre. Le fichier doit avoir été ouvert avec FILE_FLAG_SEQUENTIAL_SCAN et FILE_FLAG_OVERLAPPED.
dwFlags
Les attributs associés au fichier. Par défaut, HSE_IO_DISCONNECT_AFTER_SEND. Voir ServerSupportFunction dans la Plate-forme SDK pour obtenir une liste d'attributs possibles.
pstrHeader
Pointeur vers la chaîne contenant l'en-tête à envoyer avant de transmettre les données du fichier. L'en-tête transmet au navigateur de réception du type de données envoyées et comment il doit être affiché. Si NULL, l'en-tête n'est pas envoyé.
dwHeaderLen
La longueur de l'en-tête. Par défaut, 0. Si pstrHeader n'est pas NULLet que dwHeaderLen est 0, la fonction utilise la fonction Win32 lstrlen pour trouver la longueur de la remorque. (Dans ce cas, pstrTrailer doit être une chaîne terminée par null.)
pstrTrailer
Pointeur vers la chaîne contenant la remorque à envoyer après la transmission de données du fichier. Si la valeur NULL, la remorque n'est pas envoyé.
dwTrailerLen
La longueur de la remorque. Par défaut, 0. Si pstrTrailer n'est pas NULLet que dwTrailerLen est 0, la fonction utilise le Win32 fonction lstrlen pour trouver la longueur de la remorque. (Dans ce cas, pstrTrailer doit être une chaîne terminée par null.)
Remarques
Appelez cette fonction membre pour transmettre un fichier à un demandeur. Cette fonction membre effectue les opérations de l'indicateur de commande ServerSupportFunction HSE_REQ_TRANSMIT_FILE. Le serveur exécute cette opération de façon asynchrone. Le serveur soumet cette opération dans sa file d'attente I/O asynchrone interne et retourne à l'appelant. MFC modifie l'objet de contexte à retourner HSE_STATUS_PENDINGet utilisera HSE_DONE_WITH_SESSION lorsque le rappel indique l'achèvement de la MFC I/O. définit également m_bSendHeaders dans l'objet de contexte faux, parce que les en-têtes sont envoyés automatiquement.
Voir le PINBALL échantillon pour une démonstration de cette fonction membre.
Aperçu CHttpServerContext |nbsp ; Membres de la classe | Graphique de la hiérarchie
Voir aussi
CHttpServerContext::ServerSupportFunction