HttpAddUrlToUrlGroup-Funktion (http.h)
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 |
|---|---|
|
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. |
|
Der aufrufende Prozess verfügt nicht über die Berechtigung zum Registrieren der URL. |
|
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 |