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
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über die Berechtigung zum Registrieren der URL.
ERROR_DLL_INIT_FAILED	Die aufrufende Anwendung hat httpInitialize vor dem Aufruf dieser Funktion nicht aufgerufen.
ERROR_INVALID_PARAMETER	Einer der Parameter ist ungültig.
ERROR_ALREADY_EXISTS	Der angegebene UrlPrefix-Wert stellt einen Konflikt mit einer vorhandenen Registrierung her.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen zum Abschließen des Vorgangs.
Andere	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

Weitere Informationen

Funktionen der HTTP-Server-API, Version 1.0

HttpAddUrlToUrlGroup

HttpRemoveUrl