Funzione HttpShutdownRequestQueue (http.h)
La funzione HttpShutdownRequestQueue arresta l'accodamento delle richieste per il processo di coda di richiesta specificato. Le chiamate in sospeso a HttpReceiveHttpRequest vengono annullate.
Sintassi
HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
[in] HANDLE RequestQueueHandle
);
Parametri
[in] RequestQueueHandle
Handle alla coda della richiesta arrestata. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .
Valore restituito
Se la funzione ha esito positivo, restituisce NO_ERROR
Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
Il parametro ReqQueueHandle non contiene una coda di richieste valida.
L'applicazione non dispone dell'autorizzazione per arrestare la coda della richiesta. |
Commenti
HttpShutdownRequestQueue annulla le richieste in sospeso e arresta tutte le elaborazioni nel processo di coda delle richieste. I passaggi seguenti vengono eseguiti quando questa funzione viene chiamata:
- Il processo di coda della richiesta è contrassegnato per la pulizia e non vengono indirizzate nuove richieste al processo di coda della richiesta.
- Se il processo chiamante è un controller, le chiamate HttpWaitForDemandStart in sospeso vengono annullate.
- Le chiamate HttpReceiveHttpRequest in sospeso dal processo di chiamata vengono annullate.
- Le richieste già associate al processo di chiamata vengono annullate.
- Le richieste in sospeso in attesa accodate al processo di coda della richiesta vengono reindirizzate a un altro processo di coda delle richieste. Se non è disponibile alcun altro processo di coda richiesta, le richieste in sospeso vengono salvate fino alla chiusura della coda della richiesta o viene avviato un altro processo di coda di richieste non controller.
- Le chiamate HttpWaitForDisconnect in sospeso avviate dal processo di chiamata vengono annullate.
- Le risposte in sospeso indicate dal processo di chiamata non sono interessate, vengono completate correttamente.
Tenere presente che se l'handle della coda di richiesta è condiviso da più processi, HttpShutdownRequestQueue limita la pulizia al processo di chiamata. Altri processi attualmente in uso sulla coda della richiesta non sono interessati.
HttpShutdownRequestQueue può essere usato dalle applicazioni per riciclare i processi di coda delle richieste. A questo scopo, HttpShutdownRequestQueue viene chiamato prima di terminare un processo che condivide la coda della richiesta con altri processi. Dopo aver restituito HttpShutdownRequestQueue , il processo può essere terminato o riciclato in modo sicuro.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | http.h |
| Libreria | Httpapi.lib |
| DLL | Httpapi.dll |