Partager via


Fonction HttpAddUrlToUrlGroup (http.h)

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.

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

Voir aussi

Fonctions DE l’API serveur HTTP version 2.0

HttpAddUrl

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

HttpSetUrlGroupProperty

Chaînes UrlPrefix