Partager via

WinHttpResetAutoProxy, fonction (winhttp.h)

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
  • Last updated on