Fonction HttpRemoveUrlFromUrlGroup (http.h)

Article
02/29/2024

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.

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