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 |
|---|---|
|
L’application appelante n’a pas l’autorisation de supprimer l’URL. |
|
Un ou plusieurs des paramètres fournis sont sous une forme inutilisable. |
|
Ressources insuffisantes pour terminer l’opération. |
|
Le paramètre UrlPrefix spécifié est introuvable dans la base de données d’inscription. |
|
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 |