WinHttpGetIEProxyConfigForCurrentUser 函式 (winHTTP.h)
WinHttpGetIEProxyConfigForCurrentUser函式會擷取目前使用者的 Internet Explorer Proxy 組態。
語法
WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
[in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);
參數
[in, out] pProxyConfig
輸入上的指標,指向 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 結構。 在輸出時,結構包含目前作用中網路連線的 Internet Explorer Proxy 設定 (,例如 LAN、撥號或 VPN 連線) 。
傳回值
如果成功,則傳回 TRUE ,否則傳回 FALSE 。 如需擴充錯誤資訊,請呼叫 GetLastError。 傳回的錯誤碼如下。
錯誤碼 | 描述 |
---|---|
|
找不到 Internet Explorer Proxy 設定。 |
|
發生內部錯誤。 |
|
記憶體不足,無法完成要求的作業。 (Windows 錯誤碼) |
備註
在 Internet Explorer 中,Proxy 設定位於[工具 / 網際網路選項] 功能表選項的 [連線] 索引標籤上。 Proxy 設定是以每個連線為基礎進行設定;也就是說,LAN 連線的 Proxy 設定與撥號或 VPN 連線的設定不同。 WinHttpGetIEProxyConfigForCurrentUser 會傳回目前作用中連線的 Proxy 設定。
此函式適用于在 Web Proxy 自動探索 (WPAD) 通訊協定未實作的網路環境中執行的用戶端應用程式, (表示沒有 Proxy 自動組態檔可供使用) 。 如果無法使用 PAC 檔案, 則 WinHttpGetProxyForUrl 函式會失敗。 WinHttpGetIEProxyConfigForCurrentUser函式可作為後援機制,藉由在 Internet Explorer 中擷取使用者的 Proxy 組態來探索可運作的 Proxy 組態。
此函式不應該用於未模擬登入使用者的服務程式中。如果呼叫端未模擬登入的使用者,WinHTTP 會嘗試擷取目前服務進程的 Internet Explorer 設定:例如,本機服務或網路服務。 如果未針對這些系統帳戶設定 Internet Explorer 設定, 則對 WinHttpGetIEProxyConfigForCurrentUser 的呼叫將會失敗。
呼叫端必須在非Null結構 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG中釋放lpszProxy、lpszProxyBypass和lpszAutoConfigUrl字串。 使用 GlobalFree 釋放字串。
規格需求
最低支援的用戶端 | Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winHTTP.h |
程式庫 | WinHTTP.lib |
Dll | Winhttp.dll |