Función HttpShutdownRequestQueue (http.h)
La función HttpShutdownRequestQueue detiene las solicitudes de puesta en cola para el proceso de cola de solicitudes especificado. Se cancelan las llamadas pendientes a HttpReceiveHttpRequest .
Sintaxis
HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
[in] HANDLE RequestQueueHandle
);
Parámetros
[in] RequestQueueHandle
Identificador de la cola de solicitudes que se cierra. Se crea una cola de solicitudes y su identificador devuelto por una llamada a la función HttpCreateRequestQueue .
Valor devuelto
Si la función se ejecuta correctamente, devuelve NO_ERROR
Si se produce un error en la función, devuelve uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
El parámetro ReqQueueHandle no contiene una cola de solicitudes válida.
La aplicación no tiene permiso para apagar la cola de solicitudes. |
Comentarios
HttpShutdownRequestQueue cancela las solicitudes pendientes y detiene todo el procesamiento en el proceso de cola de solicitudes. Los pasos siguientes se realizan cuando se llama a esta función:
- El proceso de cola de solicitudes está marcado para la limpieza y no se enruta ninguna nueva solicitud al proceso de cola de solicitudes.
- Si el proceso de llamada es un controlador, se cancelan las llamadas HttpWaitForDemandStart pendientes.
- Se cancelan las llamadas HttpReceiveHttpRequest pendientes desde el proceso de llamada.
- Las solicitudes que ya están enlazadas al proceso de llamada se cancelan.
- Las solicitudes pendientes no recibidas que se ponen en cola en el proceso de cola de solicitudes se vuelven a enrutar a otro proceso de cola de solicitudes. Si no hay ningún otro proceso de cola de solicitudes disponible, las solicitudes pendientes se guardan hasta que se cierra la cola de solicitudes o se inicia otro proceso de cola de solicitudes que no es de controlador.
- Se cancelan las llamadas HttpWaitForDisconnect pendientes iniciadas por el proceso de llamada.
- Las respuestas pendientes indicadas por el proceso de llamada no se ven afectadas, se completan correctamente.
Tenga en cuenta que si varios procesos comparten el identificador de la cola de solicitudes, HttpShutdownRequestQueue limita la limpieza al proceso de llamada. Otros procesos que trabajan actualmente en la cola de solicitudes no se ven afectados.
Las aplicaciones pueden usar HttpShutdownRequestQueue para reciclar los procesos de cola de solicitudes. Para ello, se llama a HttpShutdownRequestQueue antes de finalizar un proceso que comparte la cola de solicitudes con otros procesos. Después de que HttpShutdownRequestQueue vuelva, el proceso se puede finalizar o reciclar de forma segura.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | http.h |
| Library | Httpapi.lib |
| Archivo DLL | Httpapi.dll |