WinHttpResetAutoProxy, fonction (winhttp.h)

Article
03/15/2023

La fonction WinHttpResetAutoProxy réinitialise le proxy automatique.

Syntaxe

WINHTTPAPI DWORD WinHttpResetAutoProxy(
  [in] HINTERNET hSession,
  [in] DWORD     dwFlags
);

Paramètres

[in] hSession

Handle de session WINHTTP HINTERNET valide retourné par un appel précédent à la fonction WinHttpOpen .

[in] dwFlags

Ensemble d’indicateurs qui affectent l’opération de réinitialisation.

Les indicateurs suivants sont pris en charge comme défini dans le fichier d’en-tête Winhttp.h .

Valeur	Signification
WINHTTP_RESET_STATE 0x00000001	Force un vidage et une nouvelle tentative d’informations de proxy non persistantes sur le réseau actuel.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK 0x00000002	Videz les informations PAD pour le réseau actuel.
WINHTTP_RESET_SWPAD_ALL 0x00000004	Videz les informations PAD pour tous les réseaux.
WINHTTP_RESET_SCRIPT_CACHE 0x00000008	Videz le cache HTTP persistant des scripts proxy.
WINHTTP_RESET_ALL 0x0000FFFF	Force le vidage et la nouvelle tentative de toutes les informations de proxy sur le réseau actuel.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED 0x00010000	Videz les informations de proxy actuelles et informez que le réseau a changé.
WINHTTP_RESET_OUT_OF_PROC 0x00020000	Agir sur le service autoproxy au lieu du processus actuel. Note Cet indicateur est obligatoire. Les applications qui utilisent la fonction WinHttpGetProxyForUrl pour vider la mise en cache in-process doivent fermer le handle hInternet et ouvrir un nouveau handle pour les appels futurs.

Valeur retournée

Code indiquant la réussite ou l’échec de l’opération.

Code de retour	Description
ERROR_SUCCESS	L'opération a réussi.
ERROR_INVALID_HANDLE	Le paramètre hSession n’est pas un handle valide.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE	Le paramètre hSession n’est pas le produit d’un appel à WinHttpOpen.

Remarques

Pour tout réinitialiser, définissez le paramètre dwFlags de manière à inclure WINHTTP_RESET_ALL et WINHTTP_RESET_OUT_OF_PROC.

Note Si vous effectuez des appels ultérieurs à la fonction WinHttpResetAutoProxy , il doit y avoir au moins 30 secondes de délai entre les appels pour réinitialiser l’état du proxy automatique. S’il y a moins de 30 secondes, l’appel de fonction WinHttpResetAutoProxy peut retourner ERROR_SUCCESS mais la réinitialisation ne se produit pas.

Configuration requise


Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winhttp.h
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll

Partager via