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 |
|---|---|
|
Non è possibile trovare impostazioni proxy di Internet Explorer. |
|
Si è verificato un errore interno. |
|
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 |