HttpCreateHttpHandle-Funktion (http.h)

Die HttpCreateHttpHandle-Funktion erstellt eine HTTP-Anforderungswarteschlange für die aufrufende Anwendung und gibt ein Handle zurück.

Ab VERSION 2.0 der HTTP-Server-API sollten Anwendungen HttpCreateRequestQueue aufrufen, um die Anforderungswarteschlange zu erstellen. HttpCreateHttpHandle sollte nicht verwendet werden.

Syntax

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Parameter

[out] RequestQueueHandle

Ein Zeiger auf eine Variable, die ein Handle an die Anforderungswarteschlange empfängt.

[in] Reserved

Reserviert. Dieser Parameter muss null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_DLL_INIT_FAILED	Die aufrufende Anwendung hat httpInitialize vor dem Aufrufen dieser Funktion nicht aufgerufen.
Andere	Ein in WinError.h definierter Systemfehlercode .

Hinweise

Die Anforderungswarteschlange ermöglicht es der aufrufenden Anwendung, Anforderungen für bestimmte URLs zu empfangen. Die aufrufende Anwendung verwendet die HttpAddUrl-Funktion , um die URL anzugeben, für die Anforderungen empfangen werden sollen.

Eine Anwendung sollte eine einzelne Anforderungswarteschlange verwenden, um Anforderungen zu empfangen. Die Verwendung mehrerer Anforderungswarteschlangen aus einem einzelnen Prozess erhöht weder die Antwortzeit noch den Durchsatz.

Wenn eine Anwendung die Anforderungen empfangen hat, sollte sie die CloseHandle-Funktion aufrufen, um das Handle zu schließen.

Anforderungen

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

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpAddUrl

HttpCreateRequestQueue