WinHttpGetIEProxyConfigForCurrentUser, fonction (winhttp.h)

  • Article

La fonction WinHttpGetIEProxyConfigForCurrentUser récupère la configuration du proxy Internet Explorer pour l’utilisateur actuel.

Syntaxe

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

Paramètres

[in, out] pProxyConfig

Pointeur, lors de l’entrée, vers une structure WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . À la sortie, la structure contient les paramètres de proxy Internet Explorer pour la connexion réseau active actuelle (par exemple, réseau local, connexion à distance ou VPN).

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Parmi les codes d’erreur retournés figurent les suivants.

Code d'erreur Description
ERROR_FILE_NOT_FOUND
 Aucun paramètre de proxy internet Explorer n’est disponible.
ERROR_WINHTTP_INTERNAL_ERROR
 Une erreur interne s'est produite.
ERROR_NOT_ENOUGH_MEMORY
 La mémoire disponible était insuffisante pour terminer l’opération demandée. (Code d’erreur Windows)

Remarques

Dans Internet Explorer, les paramètres de proxy se trouvent sous l’onglet Connexions de l’option de menu Outils / Options Internet. Les paramètres de proxy sont configurés par connexion ; Autrement dit, les paramètres de proxy d’une connexion LAN sont distincts de ceux d’une connexion d’accès à distance ou VPN. WinHttpGetIEProxyConfigForCurrentUser retourne les paramètres de proxy pour la connexion active actuelle.

Cette fonction est utile dans les applications clientes s’exécutant dans des environnements réseau dans lesquels le protocole WPAD (Web Proxy Auto-Discovery) n’est pas implémenté (ce qui signifie qu’aucun fichier de configuration automatique du proxy n’est disponible). Si un fichier PAC n’est pas disponible, la fonction WinHttpGetProxyForUrl échoue. La fonction WinHttpGetIEProxyConfigForCurrentUser peut être utilisée comme mécanisme de secours pour découvrir une configuration de proxy utilisable en récupérant la configuration du proxy de l’utilisateur dans internet Explorer.

Cette fonction ne doit pas être utilisée dans un processus de service qui n’emprunte pas l’identité d’un utilisateur connecté. Si l’appelant n’emprunte pas l’identité d’un utilisateur connecté, WinHTTP tente de récupérer les paramètres de Explorer Internet pour le processus de service actuel , par exemple, le service local ou le service réseau. Si les paramètres de Explorer Internet ne sont pas configurés pour ces comptes système, l’appel à WinHttpGetIEProxyConfigForCurrentUser échoue.

L’appelant doit libérer les chaînes lpszProxy, lpszProxyBypass et lpszAutoConfigUrl dans la structure WINHTTP_CURRENT_USER_IE_PROXY_CONFIG si elles ne sont pas NULL. Utilisez GlobalFree pour libérer les chaînes.

Configuration requise

   
Client minimal pris en charge Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winhttp.h
Bibliothèque Winhttp.lib
DLL Winhttp.dll

Voir aussi

WinHTTP Versions