Funzione HttpWaitForDisconnect (http.h)

Articolo
08/24/2023

La funzione HttpWaitForDisconnect notifica all'applicazione quando la connessione a un client HTTP viene interrotta per qualsiasi motivo.

Sintassi

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

Parametri

[in] RequestQueueHandle

Handle alla coda di richiesta che gestisce le richieste dalla connessione specificata. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .

Windows Server 2003 con SP1 e Windows XP con SP2: L'handle della coda della richiesta viene creato dalla funzione HttpCreateHttpHandle .

[in] ConnectionId

Identificatore per la connessione al computer client. Questo valore viene restituito nel membro ConnectionID della struttura HTTP_REQUEST da una chiamata alla funzione HttpReceiveHttpRequest .

[in] Overlapped

Per le chiamate asincrone, impostare pOverlapped per puntare a una struttura OVERLAPPED ; per le chiamate sincrone, impostarla su NULL.

Una chiamata sincrona blocca finché la connessione non viene interrotta, mentre una chiamata asincrona restituisce immediatamente ERROR_IO_PENDING e l'applicazione chiamante usa quindi le porte di completamento GetOverlappedResult o I/O per determinare quando l'operazione viene completata. Per informazioni sull'uso di strutture OVERLAPPED per la sincronizzazione, vedere Sincronizzazione e output sovrapposti.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione viene usata in modo asincrono, un valore restituito di ERROR_IO_PENDING indica che la richiesta successiva non è ancora pronta e viene recuperata in seguito tramite normali meccanismi di completamento di I/O sovrapposti.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Uno o più dei parametri forniti sono in un formato inutilizzabile.
Altri	Codice di errore di sistema definito in WinError.h.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll

Vedi anche

Funzioni API SERVER HTTP versione 1.0

HTTP_REQUEST

Condividi tramite