HttpCreateUrlGroup-Funktion (http.h)

Artikel
08/24/2023

Die HttpCreateUrlGroup-Funktion erstellt eine URL-Gruppe unter der angegebenen Serversitzung.

Syntax

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

Parameter

[in] ServerSessionId

Der Bezeichner der Serversitzung, unter der die URL-Gruppe erstellt wird.

[out] pUrlGroupId

Ein Zeiger auf die Variable, die die ID der URL-Gruppe empfängt.

[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	Der Parameter ServerSessionId gibt eine nicht vorhandene Serversitzung an. Der pUrlGroupId-Parameter ist NULL. Der Reserved-Parameter ist ungleich 0 (null).

Wert

Bedeutung

ERROR_INVALID_PARAMETER

Der Parameter ServerSessionId gibt eine nicht vorhandene Serversitzung an.

Der pUrlGroupId-Parameter ist NULL.

Der Reserved-Parameter ist ungleich 0 (null).

Hinweise

URL-Gruppen sind Konfigurationscontainer für eine Reihe von URLs. Sie werden unter der Serversitzung erstellt und erben die Konfigurationseinstellungen der Serversitzung. Wenn ein Konfigurationsparameter für die URL-Gruppe festgelegt ist, überschreibt er den Konfigurationssatz für die Serversitzung. Weitere Informationen zu den Einstellungskonfigurationen für die URL-Gruppe finden Sie unter HttpSetUrlGroupProperty.

Nachdem die URL-Gruppe erstellt wurde, muss sie einer Anforderungswarteschlange zugeordnet werden, um Anforderungen zu empfangen. Um die URL-Gruppe einer Anforderungswarteschlange zuzuordnen, ruft die Anwendung HttpSetUrlGroupProperty mit der HttpServerBindingProperty-Eigenschaft auf. Wenn diese Eigenschaft nicht festgelegt ist, werden übereinstimmende Anforderungen für die URL-Gruppe nicht an eine Anforderungswarteschlange übermittelt, und die HTTP-Server-API generiert eine 503-Antwort.

Die Zuordnung einer URL-Gruppe zu einer Anforderungswarteschlange ist dynamisch. Die Zuordnung zur Serversitzung kann erst geändert werden, wenn entweder die Serversitzung oder die URL-Gruppe gelöscht wurde. Wenn eine Serversitzung gelöscht wird, werden auch alle zugeordneten URL-Gruppen automatisch geschlossen.

Die URL-Gruppe wird zunächst als leere Gruppe erstellt. URLs müssen der Gruppe durch Aufrufen von HttpAddUrlToUrlGroup hinzugefügt werden.

Die Anwendung kann aus den folgenden Gründen mehrere URL-Gruppen erstellen:

So legen Sie unterschiedliche Konfigurationen für verschiedene Teile des URL-Namensraums fest, an denen sie lauscht.
So legen Sie separate Anforderungswarteschlangen für verschiedene Teile des URL-Namensbereichs fest, an denen sie lauscht.

Anwendungen sollten URLs so weit wie möglich in Gruppen kombinieren. Andernfalls wird die Leistung beeinträchtigt, und eine erhöhte Arbeitsspeicherauslastung des Systems wirkt sich auf die Skalierbarkeit aus.

Die HTTP-Server-API unterstützt keine asynchrone E/A für URL-Gruppen.

Wenn die URL-Gruppe nicht mehr benötigt wird oder bevor die Anwendung beendet wird, muss sie die URL-Gruppe durch Aufrufen von HttpCloseUrlGroup löschen.

Die URL-Gruppe wird mit derselben Version wie die Serversitzung erstellt, unter der sie erstellt wird.

Anforderungen


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