WinHttpDetectAutoProxyConfigUrl 函式 (winHTTP.h)
WinHttpDetectAutoProxyConfigUrl函式會尋找 Proxy 自動設定 (PAC) 檔案的 URL。 此函式會報告 PAC 檔案的 URL,但不會下載檔案。
語法
WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
[in] DWORD dwAutoDetectFlags,
[out] LPWSTR *ppwstrAutoConfigUrl
);
參數
[in] dwAutoDetectFlags
資料類型,指定要用來尋找 PAC 檔案的通訊協定。 如果已設定 DHCP 和 DNS 自動偵測旗標,則會先使用 DHCP;如果沒有使用 DHCP 探索到 PAC URL,則會使用 DNS。
值 | 意義 |
---|---|
|
使用 DHCP 尋找 Proxy 自動組態檔。 |
|
使用 DNS 嘗試在本機電腦的網域上已知位置找到 Proxy 自動組態檔。 |
[out] ppwstrAutoConfigUrl
資料類型,傳回 Null 終止 Unicode 字串的指標,其中包含接收 Proxy 資料的組態 URL。 您必須使用GlobalFree函式釋放ppwszAutoConfigUrl所指向的字串。
傳回值
如果成功,則傳回 TRUE ,否則傳回 FALSE 。 如需擴充錯誤資訊,請呼叫 GetLastError。 傳回的錯誤碼如下。
錯誤碼 | 描述 |
---|---|
|
如果 WinHTTP 無法探索 Proxy 自動設定的 URL (PAC) 檔案,則傳回 。 |
|
發生內部錯誤。 |
|
記憶體不足,無法完成要求的作業。 (Windows 錯誤碼) |
備註
WinHTTP 會實作 Web Proxy 自動探索 (WPAD) 通訊協定,通常稱為 autoproxy。 如需已知位置的詳細資訊,請參閱 WPAD 通訊協定檔的 探索程式 一節。
請注意,因為 WinHttpDetectAutoProxyConfigUrl 函式需要一段時間才能完成其作業,所以不應該從 UI 執行緒呼叫它。
規格需求
最低支援的用戶端 | Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winHTTP.h |
程式庫 | WinHTTP.lib |
Dll | Winhttp.dll |