WINHTTP_AUTOPROXY_OPTIONS 結構 (winHTTP.h)

  • 發行項

WINHTTP_AUTOPROXY_OPTIONS 結構可用來向 WinHttpGetProxyForURL 函式指出是否要指定 Proxy 自動設定 (PAC) 檔案的 URL，或是使用 DHCP 或 DNS 查詢自動尋找網路 URL。

語法

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

成員

dwFlags

機制應該用來取得 PAC 檔案。

值 意義
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 透過自動設定 URL 啟用 Proxy 偵測。
 
注意Windows 10 1703 版 (10.0 中引進此旗標的支援;組建 15063) 。
 
WINHTTP_AUTOPROXY_ALLOW_CM
 透過連接管理員啟用 Proxy 偵測。
 
注意Windows 10 1703 版 (10.0 中引進此旗標的支援;組建 15063) 。
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 透過靜態組態啟用 Proxy 偵測。
 
注意Windows 10 1703 版 (10.0 中引進此旗標的支援;組建 15063) 。
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 嘗試使用 DHCP 和 DNS 查詢，自動探索 PAC 檔案的 URL 至局域網路。
WINHTTP_AUTOPROXY_CONFIG_URL
 從 WINHTTP_AUTOPROXY_OPTIONS 結構中lpszAutoConfigUrl 指定的 URL 下載 PAC 檔案。
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 維護傳遞至 PAC 腳本的主機名案例。 這是預設行為。
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 將主機名轉換為小寫，再將它們傳遞至 PAC 腳本。
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 停用查詢主機以 Proxy 快取腳本執行結果目前進程。
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 停用查詢主機以 Proxy 快取腳本執行結果的 autoproxy 服務。
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 停用查詢此要求的直接存取 Proxy 設定。
WINHTTP_AUTOPROXY_RUN_INPROCESS
 如果可用，請執行 Web Proxy 自動探索 (WPAD) 通訊協定，而不是委派給跨進程 WinHTTP AutoProxy 服務。 此旗標必須與其中一個其他旗標結合。

當傳遞至 WinHttpGetProxyForUrlEx 時，此選項沒有任何作用。

注意 此旗標已被取代。
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 根據預設，WinHTTP 會設定為回復為自動探索進程中的 Proxy。 如果此後援行為在進程外探索失敗時不想要，則可以使用此旗標加以停用。

當傳遞至 WinHttpGetProxyForUrlEx 時，此選項沒有任何作用。

注意 此旗標僅適用於 Windows Server 2003。
 
WINHTTP_AUTOPROXY_SORT_RESULTS
根據啟發學習法先排序 Proxy 結果，先放置最快的 Proxy。

dwAutoDetectFlags

如果 dwFlags 包含WINHTTP_AUTOPROXY_AUTO_DETECT旗標， dwAutoDetectFlags 會指定要用來尋找 PAC 檔案的通訊協定。 如果同時指定 DHCP 和 DNS 自動偵測旗標，則會先使用 DHCP;如果沒有使用 DHCP 探索到 PAC URL，則會使用 DNS。

如果 dwFlags 不包含WINHTTP_AUTOPROXY_AUTO_DETECT旗標， 則 dwAutoDetectFlags 必須為零。

值 意義
WINHTTP_AUTO_DETECT_TYPE_DHCP
 使用 DHCP 尋找 Proxy 自動組態檔。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 使用 DNS 嘗試在本機計算機的網域上已知位置找到 Proxy 自動組態檔。

lpszAutoConfigUrl

如果 dwFlags 包含WINHTTP_AUTOPROXY_CONFIG_URL旗標， lpszAutoConfigUrl 必須指向 Null 終止的 Unicode 字串，其中包含 Proxy 自動設定的 URL (PAC) 檔案。

如果 dwFlags 不包含WINHTTP_AUTOPROXY_CONFIG_URL旗標， 則 lpszAutoConfigUrl 必須是 NULL。

lpvReserved

保留供日後使用;必須是 NULL。

dwReserved

保留以備將來之用；必須為零。

fAutoLogonIfChallenged

指定當 WinHTTP 要求 PAC 檔案時，是否應該自動傳送用戶端的網域認證，以回應 NTLM 或交涉驗證挑戰。

如果此旗標為 TRUE，應該會自動傳送認證以響應驗證挑戰。 如果此旗標為 FALSE，且需要驗證才能下載 PAC 檔案， WinHttpGetProxyForUrl 函式會失敗。

規格需求

需求 值
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
標頭 winhttp.h

另請參閱

WinHTTP 版本