Partager via


Fonction HttpRemoveUrl (http.h)

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