Fonction HttpCreateUrlGroup (http.h)

Article
08/24/2023

La fonction HttpCreateUrlGroup crée un groupe d’URL sous la session de serveur spécifiée.

Syntaxe

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

Paramètres

[in] ServerSessionId

Identificateur de la session de serveur sous laquelle le groupe d’URL est créé.

[out] pUrlGroupId

Pointeur vers la variable qui reçoit l’ID du groupe d’URL.

[in] Reserved

Réservé. Doit être zéro.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR

Si la fonction échoue, elle retourne l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_INVALID_PARAMETER	Le paramètre ServerSessionId indique une session de serveur inexistante. Le paramètre pUrlGroupId est null. Le paramètre Reserved est différent de zéro.

Valeur

Signification

ERROR_INVALID_PARAMETER

Le paramètre ServerSessionId indique une session de serveur inexistante.

Le paramètre pUrlGroupId est null.

Le paramètre Reserved est différent de zéro.

Notes

Les groupes d’URL sont des conteneurs de configuration pour un ensemble d’URL. Ils sont créés sous la session serveur et héritent des paramètres de configuration de la session de serveur. Lorsqu’un paramètre de configuration est défini sur le groupe d’URL, il remplace le jeu de configuration sur la session serveur. Pour plus d’informations sur les configurations de paramètres pour le groupe d’URL, consultez HttpSetUrlGroupProperty.

Une fois le groupe d’URL créé, il doit être associé à une file d’attente de demandes pour recevoir des demandes. Pour associer le groupe d’URL à une file d’attente de requêtes, l’application appelle HttpSetUrlGroupProperty avec la propriété HttpServerBindingProperty . Si cette propriété n’est pas définie, les demandes correspondantes pour le groupe d’URL ne sont pas remises à une file d’attente de requêtes et l’API serveur HTTP génère une réponse 503.

L’association du groupe d’URL à une file d’attente de requêtes est dynamique. L’association avec la session de serveurs ne peut pas être modifiée tant que la session de serveur ou le groupe d’URL n’est pas supprimé. Lorsqu’une session de serveur est supprimée, tous les groupes d’URL associés sont également automatiquement fermés.

Le groupe d’URL est initialement créé en tant que groupe vide. Les URL doivent être ajoutées au groupe en appelant HttpAddUrlToUrlGroup.

L’application peut créer plusieurs groupes d’URL pour les raisons suivantes :

Pour définir des configurations distinctes pour différentes parties de l’espace de nom d’URL sur lequel il écoute.
Pour définir des files d’attente de requêtes distinctes pour différentes parties de l’espace de nom d’URL sur laquelle il écoute.

Les applications doivent combiner les URL en groupes autant que possible ; sinon, les performances se dégradent et l’augmentation de la consommation de mémoire du système affecte la scalabilité.

L’API serveur HTTP ne prend pas en charge les E/S asynchrones sur les groupes d’URL.

Lorsque le groupe d’URL n’est plus nécessaire ou avant la fin de l’application, il doit supprimer le groupe d’URL en appelant HttpCloseUrlGroup.

Le groupe d’URL est créé avec la même version que la session de serveur sous laquelle il est créé.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	http.h
Bibliothèque	Httpapi.lib
DLL	Httpapi.dll