Fonction HttpWaitForDisconnect (http.h)

La fonction HttpWaitForDisconnect avertit l’application lorsque la connexion à un client HTTP est interrompue pour une raison quelconque.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpWaitForDisconnect(
  [in] HANDLE             RequestQueueHandle,
  [in] HTTP_CONNECTION_ID ConnectionId,
  [in] LPOVERLAPPED       Overlapped
);

Paramètres

[in] RequestQueueHandle

Handle de la file d’attente des demandes qui gère les demandes de la connexion spécifiée. Une file d’attente de requêtes est créée et son handle est retourné par un appel à la fonction HttpCreateRequestQueue .

Windows Server 2003 avec SP1 et Windows XP avec SP2 : Le handle de la file d’attente des requêtes est créé par la fonction HttpCreateHttpHandle .

[in] ConnectionId

Identificateur de la connexion à l’ordinateur client. Cette valeur est retournée dans le membre ConnectionID de la structure HTTP_REQUEST par un appel à la fonction HttpReceiveHttpRequest .

[in] Overlapped

Pour les appels asynchrones, définissez pOverlapped pour qu’il pointe vers une structure CHEVAUCHEMENT . pour les appels synchrones, définissez-le sur NULL.

Un appel synchrone se bloque jusqu’à ce que la connexion soit interrompue, tandis qu’un appel asynchrone retourne immédiatement ERROR_IO_PENDING et que l’application appelante utilise ensuite les ports d’achèvement GetOverlappedResult ou E/S pour déterminer quand l’opération est terminée. Pour plus d’informations sur l’utilisation de structures OVERLAPPED pour la synchronisation, consultez Synchronisation et entrée et sortie qui se chevauchent.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction est utilisée de manière asynchrone, une valeur de retour de ERROR_IO_PENDING indique que la requête suivante n’est pas encore prête et qu’elle est récupérée ultérieurement par le biais de mécanismes d’achèvement d’E/S qui se chevauchent normalement.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres fournis sont sous une forme inutilisable.
Autres	Code d’erreur système défini dans WinError.h.

Spécifications

Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	http.h
Bibliothèque	Httpapi.lib
DLL	Httpapi.dll

Voir aussi

Fonctions de l’API serveur HTTP version 1.0

HTTP_REQUEST