Funzione WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)

La funzione WinHttpGetIEProxyConfigForCurrentUser recupera la configurazione proxy di Internet Explorer per l'utente corrente.

Sintassi

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

Parametri

[in, out] pProxyConfig

Puntatore, all'input, a una struttura WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . Nell'output la struttura contiene le impostazioni proxy di Internet Explorer per la connessione di rete attiva corrente, ad esempio LAN, connessione remota o VPN.

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per informazioni sugli errori estesi, chiamare GetLastError. Tra i codici di errore restituiti sono riportati di seguito.

Codice di errore	Descrizione
ERROR_FILE_NOT_FOUND	Non è possibile trovare impostazioni proxy di Internet Explorer.
ERROR_WINHTTP_INTERNAL_ERROR	Si è verificato un errore interno.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare l'operazione richiesta. (Codice errore di Windows)

Commenti

In Internet Explorer le impostazioni proxy sono disponibili nella scheda Connessioni dell'opzione di menu Strumenti / Opzioni Internet . Le impostazioni proxy vengono configurate per ogni connessione; ovvero, le impostazioni proxy per una connessione LAN sono separate da quelle per una connessione remota o VPN. WinHttpGetIEProxyConfigForCurrentUser restituisce le impostazioni proxy per la connessione attiva corrente.

Questa funzione è utile nelle applicazioni client in esecuzione in ambienti di rete in cui il protocollo WPAD (Web Proxy Auto-Discovery) non è implementato (ovvero non è disponibile alcun file di configurazione automatica proxy). Se un file PAC non è disponibile, la funzione WinHttpGetProxyForUrl ha esito negativo. La funzione WinHttpGetIEProxyConfigForCurrentUser può essere usata come meccanismo di fallback per individuare una configurazione proxy funzionante recuperando la configurazione proxy dell'utente in Internet Explorer.

Questa funzione non deve essere usata in un processo del servizio che non rappresenta un utente connesso. Se il chiamante non rappresenta un utente connesso, WinHTTP tenta di recuperare le impostazioni di Internet Explorer per il processo di servizio corrente, ad esempio il servizio locale o il servizio di rete. Se le impostazioni di Internet Explorer non sono configurate per questi account di sistema, la chiamata a WinHttpGetIEProxyConfigForCurrentUser avrà esito negativo.

Il chiamante deve liberare le stringhe lpszProxy, lpszProxyBypass e lpszAutoConfigUrl nella struttura WINHTTP_CURRENT_USER_IE_PROXY_CONFIG se non sono NULL. Usare GlobalFree per liberare le stringhe.

Requisiti

Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winhttp.h
Libreria	Winhttp.lib
DLL	Winhttp.dll

Vedi anche

Versioni di WinHTTP