HttpShutdownRequestQueue-Funktion (http.h)

  • Artikel

Die HttpShutdownRequestQueue-Funktion beendet die Warteschlangenanforderungen für den angegebenen Anforderungswarteschlangenprozess. Ausstehende Aufrufe von HttpReceiveHttpRequest werden abgebrochen.

Syntax

HTTPAPI_LINKAGE ULONG HttpShutdownRequestQueue(
  [in] HANDLE RequestQueueHandle
);

Parameter

[in] RequestQueueHandle

Das Handle für die Anforderungswarteschlange, die heruntergefahren wird. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück.

Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.

Wert Bedeutung
ERROR_INVALID_PARAMETER
 Der ReqQueueHandle-Parameter enthält keine gültige Anforderungswarteschlange.

Die Anwendung verfügt nicht über die Berechtigung zum Herunterfahren der Anforderungswarteschlange.

Hinweise

HttpShutdownRequestQueue bricht ausstehende Anforderungen ab und beendet die gesamte Verarbeitung im Anforderungswarteschlangenprozess. Die folgenden Schritte werden ausgeführt, wenn diese Funktion aufgerufen wird:

  1. Der Anforderungswarteschlangenprozess wird zur Bereinigung markiert, und keine neuen Anforderungen werden an den Anforderungswarteschlangenprozess weitergeleitet.
  2. Wenn es sich beim aufrufenden Prozess um einen Controller handelt, werden ausstehende HttpWaitForDemandStart-Aufrufe abgebrochen.
  3. Ausstehende HttpReceiveHttpRequest-Aufrufe vom aufrufenden Prozess werden abgebrochen.
  4. Anforderungen, die bereits an den aufrufenden Prozess gebunden sind, werden abgebrochen.
  5. Die nicht erkannten ausstehenden Anforderungen, die an den Anforderungswarteschlangenprozess umgeleitet werden, werden an einen anderen Anforderungswarteschlangenprozess weitergeleitet. Wenn kein anderer Anforderungswarteschlangenprozess verfügbar ist, werden die ausstehenden Anforderungen gespeichert, bis die Anforderungswarteschlange geschlossen oder ein anderer Nicht-Controller-Anforderungswarteschlangenprozess gestartet wird.
  6. Ausstehende HttpWaitForDisconnect-Aufrufe , die vom aufrufenden Prozess initiiert wurden, werden abgebrochen.
  7. Ausstehende Antworten, die vom aufrufenden Prozess angegeben werden, sind nicht betroffen, sie sind ordnungsgemäß abgeschlossen.

Beachten Sie, dass httpShutdownRequestQueue die Bereinigung auf den aufrufenden Prozess einschränkt, wenn das Anforderungswarteschlangenhandle von mehreren Prozessen gemeinsam genutzt wird. Andere Prozesse, die derzeit an der Anforderungswarteschlange arbeiten, sind nicht betroffen.

HttpShutdownRequestQueue kann von Anwendungen verwendet werden, um Anforderungswarteschlangenprozesse zu recyceln. Zu diesem Zweck wird HttpShutdownRequestQueue aufgerufen, bevor ein Prozess beendet wird, der die Anforderungswarteschlange für andere Prozesse gemeinsam verwendet. Nachdem HttpShutdownRequestQueue zurückgegeben wurde, kann der Prozess sicher beendet oder recycelt werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile http.h
Bibliothek Httpapi.lib
DLL Httpapi.dll

Weitere Informationen

FUNKTIONEN DER HTTP-Server-API, Version 2.0

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpSetRequestQueueProperty