Funzione HttpWaitForDisconnect (http.h)
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 |
|---|---|
|
Uno o più dei parametri forniti sono in un formato inutilizzabile. |
|
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 |