Partager via


Fonction HttpRemoveUrlFromUrlGroup (http.h)

La fonction HttpRemoveUrlFromUrlGroup supprime l’URL spécifiée du groupe identifié par l’ID de groupe d’URL. Cette fonction supprime une ou toutes les URL du groupe.

Cette fonction remplace la fonction HTTP version 1.0 HttpRemoveUrl .

Syntaxe

HTTPAPI_LINKAGE ULONG HttpRemoveUrlFromUrlGroup(
  [in] HTTP_URL_GROUP_ID UrlGroupId,
  [in] PCWSTR            pFullyQualifiedUrl,
  [in] ULONG             Flags
);

Paramètres

[in] UrlGroupId

ID du groupe d’URL à partir duquel l’URL spécifiée dans pFullyQualifiedUrl est supprimée.

[in] pFullyQualifiedUrl

Pointeur vers une chaîne Unicode qui contient une chaîne UrlPrefix correctement formée qui identifie l’URL à supprimer.

Lorsque HTTP_URL_FLAG_REMOVE_ALL est passé dans le paramètre Flags , toutes les inscriptions d’URL existantes pour le groupe d’URL identifié dans UrlGroupId sont supprimées du groupe. Dans ce cas, pFullyQualifiedUrl doit avoir la valeur NULL.

[in] Flags

Indicateurs d’URL qui qualifient l’URL supprimée. Il peut s’agir de l’un des indicateurs suivants :

Indicateur d’URL Signification
HTTP_URL_FLAG_REMOVE_ALL
Supprime toutes les URL actuellement inscrites auprès du groupe d’URL.

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 groupe d’URL n’existe pas.

Le paramètre Flags contient une combinaison d’indicateurs non valide.

L’indicateur HTTP_URL_FLAG_REMOVE_ALL a été défini et le paramètre pFullyQualifiedUrl n’a pas la valeur NULL.

L’application n’est pas autorisée à supprimer des URL du groupe. Seule l’application qui a créé le groupe d’URL peut supprimer des URL.

ERROR_ACCESS_DENIED
Le processus appelant n’est pas autorisé à annuler l’inscription de l’URL.
ERROR_FILE_NOT_FOUND
L’URL spécifiée n’est pas inscrite auprès du groupe d’URL.

Remarques

L’API serveur HTTP prend en charge les applications existantes utilisant les inscriptions d’URL de la version 1.0. Toutefois, le nouveau développement avec l’API de serveur HTTP doit utiliser HttpRemoveUrlFromUrlGroup ; n’utilisez pas HttpRemoveUrl.

Les applications doivent supprimer l’URL ajoutée au groupe par HttpAddUrlToUrlGroup, lorsque l’URL n’est plus nécessaire.

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

HttpAddUrlToUrlGroup

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrl

HttpSetUrlGroupProperty