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 |
|---|---|
|
Die aufrufende Anwendung hat httpInitialize vor dem Aufrufen dieser Funktion nicht aufgerufen. |
|
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 |