HttpCloseRequestQueue-Funktion (http.h)

Die HttpCloseRequestQueue-Funktion schließt das Handle für die angegebene Anforderungswarteschlange, die von HttpCreateRequestQueue erstellt wurde.

Die Anwendung muss die Anforderungswarteschlange schließen, wenn sie nicht mehr benötigt wird.

Syntax

HTTPAPI_LINKAGE ULONG HttpCloseRequestQueue(
  [in] HANDLE RequestQueueHandle
);

Parameter

[in] RequestQueueHandle

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

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben.

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

Wert Bedeutung
ERROR_INVALID_PARAMETER
Die Anwendung verfügt nicht über die Berechtigung zum Schließen der Anforderungswarteschlange. Nur die Anwendung, die die Anforderungswarteschlange erstellt hat, kann sie schließen.

Hinweise

Anwendungen sollten CloseHandle nicht im Anforderungswarteschlangenhandle aufrufen. Stattdessen sollten sie HttpCloseRequestQueue aufrufen, um sicherzustellen, dass alle Ressourcen freigegeben 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

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpSetRequestQueueProperty

HttpShutdownRequestQueue