HttpAddUrl-Funktion (http.h)
Die HttpAddUrl-Funktion registriert eine angegebene URL, sodass Anforderungen, die damit übereinstimmen, an eine angegebene HTTP-Server-API-Anforderungswarteschlange weitergeleitet werden. Eine Anwendung kann mithilfe wiederholter Aufrufe von HttpAddUrl mehrere URLs in einer einzelnen Anforderungswarteschlange registrieren. Weitere Informationen dazu, wie die HTTP-Server-API Anforderungs-URLs mit registrierten URLs abgleicht, finden Sie unter UrlPrefix Strings.
Ab Version 2.0 der HTTP-Server-API sollten Anwendungen HttpAddUrlToUrlGroup aufrufen, um eine URL zu registrieren. HttpAddUrl sollte nicht verwendet werden.
Syntax
HTTPAPI_LINKAGE ULONG HttpAddUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl,
PVOID Reserved
);
Parameter
[in] RequestQueueHandle
Das Handle an die Anforderungswarteschlange, an die Anforderungen für die angegebene URL weitergeleitet werden sollen. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.
Windows Server 2003 mit SP1 und Windows XP mit SP2: Das Handle für die Anforderungswarteschlange wird von der HttpCreateHttpHandle-Funktion erstellt.
[in] FullyQualifiedUrl
Ein Zeiger auf eine Unicode-Zeichenfolge, die eine ordnungsgemäß formatierte UrlPrefix-Zeichenfolge enthält, die die zu registrierende URL identifiziert.
Reserved
Reserviert; 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 verfügt nicht über die Berechtigung zum Registrieren der URL. |
|
Die aufrufende Anwendung hat httpInitialize vor dem Aufruf dieser Funktion nicht aufgerufen. |
|
Einer der Parameter ist ungültig. |
|
Der angegebene UrlPrefix-Wert stellt einen Konflikt mit einer vorhandenen Registrierung her. |
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
Ein in WinError.h definierter Systemfehlercode . |
Hinweise
Wie im Thema UrlPrefix Strings angegeben, muss die Schemaspezifikation des zu registrierenden UrlPrefix entweder "http" oder "https" in Kleinbuchstaben sein. Keine andere Teilzeichenfolge ist gültig.
Außerdem ist es nicht möglich, URLs mit unterschiedlichen Schemas am gleichen Port zu registrieren. Das heißt, die Schemas "http" und "https" können nicht gleichzeitig an einem Port vorhanden sein.
Beachten Sie auch, dass HttpAddUrl alle urlPrefix registriert, die an das HttpAddUrl übergeben werden, solange die Zeichenfolge wohlgeformt ist. Jede Überprüfung des Vorhandenseins, der Barrierefreiheit, des Besitzes oder anderer Merkmale des angegebenen URL-Namespace muss von der Anwendung behandelt werden.
Um die Ressourcen freizugeben, die als Ergebnis der registrierung durch HttpAddUrl zugewiesen wurden, führen Sie einen übereinstimmenden Aufruf der HttpRemoveUrl-Funktion durch, wenn Ihre Anwendung den betreffenden Namespace abgeschlossen hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |