Fonction HttpShutdownRequestQueue (http.h)

  • Article

La fonction HttpShutdownRequestQueue arrête la mise en file d’attente des requêtes pour le processus de file d’attente de requêtes spécifié. Les appels en attente à HttpReceiveHttpRequest sont annulés.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
  [in] HANDLE RequestQueueHandle
);

Paramètres

[in] RequestQueueHandle

Handle de la file d’attente de requêtes qui est arrêtée. Une file d’attente de requêtes est créée et son handle est retourné par un appel à la fonction HttpCreateRequestQueue .

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Valeur Signification
ERROR_INVALID_PARAMETER
 Le paramètre ReqQueueHandle ne contient pas de file d’attente de requêtes valide.

L’application n’est pas autorisée à arrêter la file d’attente des demandes.

Notes

HttpShutdownRequestQueue annule les requêtes en attente et arrête tout traitement sur le processus de file d’attente des requêtes. Les étapes suivantes sont effectuées lorsque cette fonction est appelée :

  1. Le processus de file d’attente des demandes est marqué pour le nettoyage et aucune nouvelle demande n’est routée vers le processus de file d’attente des demandes.
  2. Si le processus appelant est un contrôleur, les appels HttpWaitForDemandStart en attente sont annulés.
  3. Les appels HttpReceiveHttpRequest en attente du processus d’appel sont annulés.
  4. Les demandes qui sont déjà liées au processus d’appel sont annulées.
  5. Les demandes en attente non reçues qui sont mises en file d’attente vers le processus de file d’attente des demandes ont été redirigées vers un autre processus de file d’attente des demandes. Si aucun autre processus de file d’attente de requêtes n’est disponible, les demandes en attente sont enregistrées jusqu’à ce que la file d’attente des demandes soit fermée ou qu’un autre processus de file d’attente de requêtes non-contrôleur soit lancé.
  6. Les appels HttpWaitForDisconnect en attente lancés par le processus d’appel sont annulés.
  7. Les réponses en attente indiquées par le processus d’appel ne sont pas affectées, elles sont correctement effectuées.

N’oubliez pas que si le handle de file d’attente des requêtes est partagé par plusieurs processus, HttpShutdownRequestQueue limite le nettoyage au processus appelant. Les autres processus qui travaillent actuellement sur la file d’attente des requêtes ne sont pas affectés.

HttpShutdownRequestQueue peut être utilisé par les applications pour recycler les processus de file d’attente des demandes. À cet effet, HttpShutdownRequestQueue est appelé avant de mettre fin à un processus qui partage la file d’attente des requêtes avec d’autres processus. Après le retour de HttpShutdownRequestQueue , le processus peut être arrêté ou recyclé en toute sécurité.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [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 2.0

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpSetRequestQueueProperty