HttpAddUrlToUrlGroup-Funktion (http.h)

Artikel
02/26/2024

Die HttpAddUrlToUrlGroup-Funktion fügt die angegebene URL der URL-Gruppe hinzu, die durch die URL-Gruppen-ID identifiziert wird.

Diese Funktion ersetzt die HttpAddUrl-Funktion der HTTP-Version 1.0.

Syntax

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

Parameter

[in] UrlGroupId

Die Gruppen-ID für die URL-Gruppe, an die Anforderungen für die angegebene URL weitergeleitet werden. Die URL-Gruppe wird von der HttpCreateUrlGroup-Funktion erstellt.

[in] pFullyQualifiedUrl

Ein Zeiger auf eine Unicode-Zeichenfolge, die eine ordnungsgemäß formatierte UrlPrefix-Zeichenfolge enthält, die die zu registrierende URL identifiziert. Wenn Sie nicht als Administrator ausführen, geben Sie eine Portnummer an, die größer als 1024 ist. Andernfalls wird möglicherweise ein ERROR_ACCESS_DENIED Fehler angezeigt.

[in, optional] UrlContext

Der Kontext, der der in diesem Aufruf registrierten URL zugeordnet ist. Der URL-Kontext wird in der HTTP_REQUEST-Struktur mit jeder Anforderung zurückgegeben, die für die im Parameter pFullyQualifiedUrl angegebene URL empfangen wird.

[in] Reserved

Reserviert. Muss Null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR

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

Wert	Bedeutung
ERROR_INVALID_PARAMETER	Die UrlGroupId ist nicht vorhanden. Der Reserved-Parameter ist nicht 0 (null). Die Anwendung verfügt nicht über die Berechtigung zum Hinzufügen von URLs zur Gruppe. Nur die Anwendung, die die URL-Gruppe erstellt hat, kann URLs hinzufügen.
ERROR_ACCESS_DENIED	Der aufrufende Prozess verfügt nicht über die Berechtigung zum Registrieren der URL.
ERROR_ALREADY_EXISTS	Die angegebene URL ist in Konflikt mit einer vorhandenen Registrierung.

Wert

Bedeutung

ERROR_INVALID_PARAMETER

Die UrlGroupId ist nicht vorhanden.

Der Reserved-Parameter ist nicht 0 (null).

Die Anwendung verfügt nicht über die Berechtigung zum Hinzufügen von URLs zur Gruppe. Nur die Anwendung, die die URL-Gruppe erstellt hat, kann URLs hinzufügen.

ERROR_ACCESS_DENIED

Der aufrufende Prozess verfügt nicht über die Berechtigung zum Registrieren der URL.

ERROR_ALREADY_EXISTS

Die angegebene URL ist in Konflikt mit einer vorhandenen Registrierung.

Hinweise

Die HTTP-Server-API unterstützt vorhandene Anwendungen mithilfe von URL-Registrierungen der Version 1.0. Bei der Neuentwicklung mit der HTTP-Server-API sollte jedoch HttpAddUrlToUrlGroup verwendet werden. HttpAddUrl sollte nicht verwendet werden.

Eine Anwendung kann einer URL-Gruppe mithilfe wiederholter Aufrufe von HttpAddUrlToUrlGroup mehrere URLs hinzufügen. Anforderungen, die der angegebenen URL entsprechen, werden an die Anforderungswarteschlange weitergeleitet, die der URL-Gruppe zugeordnet ist. Weitere Informationen dazu, wie die HTTP-Server-API Anforderungs-URLs mit registrierten URLs abgleicht, finden Sie unter UrlPrefix Strings.

Anforderungen

Anforderung	Wert
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