Share via

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。 傳回的錯誤碼如下。

錯誤碼 描述
ERROR_FILE_NOT_FOUND
 找不到 Internet Explorer Proxy 設定。
ERROR_WINHTTP_INTERNAL_ERROR
 發生內部錯誤。
ERROR_NOT_ENOUGH_MEMORY
 記憶體不足，無法完成要求的作業。 (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

另請參閱

WinHTTP 版本