WinHttpConnectionDeletePolicyEntries, fonction

Supprime toutes les entrées de stratégie de routage de connexion associées à une balise de stratégie spécifique du service de proxy automatique WinHTTP.

Syntax

DWORD WINAPI WinHttpConnectionDeletePolicyEntries(
    _In_ HINTERNET                      hSession,
    _In_ WINHTTP_CONNECTION_POLICY_TAG  PolicyEntryTag
);

Parameters

hSession [in]

Handle de session WinHTTP valide créé par WinHttpOpen. Le handle doit être un handle de niveau session.

PolicyEntryTag [in]

Identifie l’ensemble d’entrées de stratégie à supprimer. Une des valeurs suivantes.

Valeur	Sens
TAG_WINHTTP_CONNECTION_POLICY_TAG_DEFAULT (0)	Entrées de stratégie par défaut/non marquées.
TAG_WINHTTP_CONNECTION_POLICY_TAG_CONNECTION_MANAGER (1)	Entrées gérées par le gestionnaire de connexions système.
TAG_WINHTTP_CONNECTION_POLICY_TAG_WWWPT (2)	Entrées gérées par le composant WWWPT (Windows Web Platform Transport).

Valeur renvoyée

Retourne ERROR_SUCCESS (0) en cas de réussite. Retourne un code d’erreur système en cas d’échec , y compris les éléments suivants.

Valeur	Description
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE	hSession n’est pas un handle de session.
ERROR_WINHTTP_NOT_INITIALIZED	Les globals WinHTTP ne sont pas initialisés.
ERROR_ACCESS_DENIED	L’appelant n’a pas de privilèges requis.

Remarks

Note

Cette API n’est actuellement pas incluse dans un fichier d’en-tête sdk. Vous devez déclarer la fonction vous-même dans votre code.

Supprime toutes les entrées de stratégie précédemment inscrites avec la balise spécifiée. Les entrées d’autres balises ne sont pas affectées.

Généralement appelé avant WinHttpConnectionSetPolicyEntries pour garantir une ardoise propre lors de l’actualisation de la stratégie à partir du composant propriétaire.

Cette API nécessite des privilèges élevés (administrateur/SYSTÈME).

Exigences

Requirement	Valeur
Header	N/A
Bibliothèque	winhttp.lib
DLL	winhttp.dll

Voir aussi

• WinHttpConnectionSetPolicyEntries
• WinHttpOpen