Fonction HttpAddUrlToUrlGroup (http.h)

Article
02/29/2024

La fonction HttpAddUrlToUrlGroup ajoute l’URL spécifiée au groupe d’URL identifié par l’ID de groupe d’URL.

Cette fonction remplace la fonction HTTP version 1.0 HttpAddUrl .

Syntaxe

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

Paramètres

[in] UrlGroupId

ID de groupe pour le groupe d’URL vers lequel les demandes pour l’URL spécifiée sont routées. Le groupe d’URL est créé par la fonction HttpCreateUrlGroup .

[in] pFullyQualifiedUrl

Pointeur vers une chaîne Unicode qui contient une chaîne UrlPrefix correctement formée qui identifie l’URL à inscrire. Si vous n’exécutez pas en tant qu’administrateur, spécifiez un numéro de port supérieur à 1024. Sinon, vous risquez d’obtenir une erreur ERROR_ACCESS_DENIED.

[in, optional] UrlContext

Contexte associé à l’URL inscrite dans cet appel. Le contexte d’URL est retourné dans la structure HTTP_REQUEST avec chaque requête reçue sur l’URL spécifiée dans le paramètre pFullyQualifiedUrl .

[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	L’UrlGroupId n’existe pas. Le paramètre Réservé n’est pas égal à zéro. L’application n’a pas l’autorisation d’ajouter des URL au groupe. Seule l’application qui a créé le groupe d’URL peut ajouter des URL.
ERROR_ACCESS_DENIED	Le processus appelant n’a pas l’autorisation d’inscrire l’URL.
ERROR_ALREADY_EXISTS	L’URL spécifiée est en conflit avec une inscription existante.

Valeur

Signification

ERROR_INVALID_PARAMETER

L’UrlGroupId n’existe pas.

Le paramètre Réservé n’est pas égal à zéro.

L’application n’a pas l’autorisation d’ajouter des URL au groupe. Seule l’application qui a créé le groupe d’URL peut ajouter des URL.

ERROR_ACCESS_DENIED

Le processus appelant n’a pas l’autorisation d’inscrire l’URL.

ERROR_ALREADY_EXISTS

L’URL spécifiée est en conflit avec une inscription existante.

Remarques

L’API serveur HTTP prend en charge les applications existantes qui utilisent les inscriptions d’URL de la version 1.0. Toutefois, le nouveau développement avec l’API de serveur HTTP doit utiliser HttpAddUrlToUrlGroup ; HttpAddUrl ne doit pas être utilisé.

Une application peut ajouter plusieurs URL à un groupe d’URL à l’aide d’appels répétés à HttpAddUrlToUrlGroup. Les demandes qui correspondent à l’URL spécifiée sont routées vers la file d’attente de requêtes associée au groupe d’URL. Pour plus d’informations sur la façon dont l’API serveur HTTP fait correspondre les URL de requête aux URL inscrites, consultez UrlPrefix Strings.

Configuration requise

Condition requise	Valeur
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