Fonction HttpRemoveUrl (http.h)

Article
08/24/2023

La fonction HttpRemoveUrl entraîne l’arrêt du routage des demandes qui correspondent à une chaîne UrlPrefix spécifiée à une file d’attente de requêtes spécifiée.

À compter de l’API serveur HTTP version 2.0, les applications doivent appeler HttpRemoveUrlFromUrlGroup pour inscrire une URL ; HttpRemoveUrl ne doit pas être utilisé.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
  [in] HANDLE RequestQueueHandle,
  [in] PCWSTR FullyQualifiedUrl
);

Paramètres

[in] RequestQueueHandle

Handle de la file d’attente de requêtes à partir de laquelle l’inscription d’URL doit être supprimée. Une file d’attente de requêtes est créée et son handle est retourné par un appel à la fonction HttpCreateRequestQueue .

Windows Server 2003 avec SP1 et Windows XP avec SP2 : Le handle de la file d’attente de requête est créé par la fonction HttpCreateHttpHandle .

[in] FullyQualifiedUrl

Pointeur vers une chaîne UrlPrefix inscrite dans la file d’attente de requêtes spécifiée. Cette chaîne doit être identique à celle passée à HttpAddUrl pour inscrire urlPrefix ; même une modification de nomenclature dans une adresse IPv6 n’est pas acceptée.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_ACCESS_DENIED	L’application appelante n’a pas l’autorisation de supprimer l’URL.
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres fournis sont sous une forme inutilisable.
ERROR_NOT_ENOUGH_MEMORY	Ressources insuffisantes pour terminer l’opération.
ERROR_FILE_NOT_FOUND	Le paramètre UrlPrefix spécifié est introuvable dans la base de données d’inscription.
Autres	Code d’erreur système défini dans WinError.h.

Configuration requise


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

Voir aussi

Fonctions API de serveur HTTP version 1.0

HttpAddUrl

HttpRemoveUrlFromUrlGroup

Share via