INTERNET_PER_CONN_OPTIONW 結構 (wininet.h)

發行項
03/04/2024

包含選項的值。

語法

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPWSTR   pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;

成員

dwOption

要查詢或設定的選項。這個成員可以是下列其中一個值。

值	意義
INTERNET_PER_CONN_AUTOCONFIG_URL	設定或擷取包含自動組態腳本 URL 的字串。
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	設定或擷取自動探索設定。 Value 成員將包含下列一或多個值： AUTO_PROXY_FLAG_ALWAYS_DETECT 一律會自動偵測設定。 AUTO_PROXY_FLAG_CACHE_INIT_RUN 指出應該使用自動 Proxy 組態腳本的快取結果，而不是實際執行腳本，除非快取的檔案已過期。 AUTO_PROXY_FLAG_DETECTION_RUN 自動偵測已在此連線上至少執行一次。 AUTO_PROXY_FLAG_DETECTION_SUSPECT 目前不支援。 AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT 不允許自動 Proxy 組態腳本的結果快取。 AUTO_PROXY_FLAG_MIGRATED 設定已從 Microsoft Internet Explorer 4.0 安裝移轉，且應該嘗試自動偵測一次。 AUTO_PROXY_FLAG_USER_SET 用戶已明確設定自動偵測。
INTERNET_PER_CONN_FLAGS	設定或擷取連接類型。 Value 成員將包含下列一或多個值： PROXY_TYPE_DIRECT 線上不會使用 Proxy 伺服器。 PROXY_TYPE_PROXY 聯機會使用明確設定的 Proxy 伺服器。 PROXY_TYPE_AUTO_PROXY_URL 聯機會在指定的 URL 下載並處理自動設定腳本。 PROXY_TYPE_AUTO_DETECT 聯機會自動偵測設定。
INTERNET_PER_CONN_PROXY_BYPASS	設定或擷取字串，其中包含不使用 Proxy 伺服器的 URL。
INTERNET_PER_CONN_PROXY_SERVER	設定或擷取包含 Proxy 伺服器的字串。
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	鏈結的自動設定 URL。當主要自動設定 URL 指向設定 Proxy 資訊第二個自動設定 URL 的 INS 檔案時使用。
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	在自動探索自動重新整理自動設定 URL 之前的分鐘數。
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	唯讀選項。傳回使用自動探索找到上次已知良好自動設定 URL 的時間。
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	唯讀選項。傳回使用自動探索找到的最後已知良好 URL。

Windows 7 和更新版本：

支援 Internet Explorer 8 的客戶端應該使用 INTERNET_PER_CONN_FLAGS_UI 來查詢連線類型。如果此查詢失敗，則系統會執行舊版 Internet Explorer，而且客戶端應該使用 INTERNET_PER_CONN_FLAGS 再次查詢。

不論 Internet Explorer 的版本為何，都使用 INTERNET_PER_CONN_FLAGS 還原連線類型。

值	意義
INTERNET_PER_CONN_FLAGS_UI	設定或擷取連接類型。 Value 成員將包含下列一或多個值： PROXY_TYPE_DIRECT 線上不會使用 Proxy 伺服器。 PROXY_TYPE_PROXY 聯機會使用明確設定的 Proxy 伺服器。 PROXY_TYPE_AUTO_PROXY_URL 聯機會在指定的 URL 下載並處理自動設定腳本。 PROXY_TYPE_AUTO_DETECT 聯機會自動偵測設定。

Value

包含選項值的等位。它可以是下列任何一種類型，視 dwOption 的值而定：

dwValue

不帶正負號的長整數值。

pszValue

字串值的指標。

ftValue

FILETIME 結構。

Value.dwValue

不帶正負號的長整數值。

Value.pszValue

字串值的指標。

Value.ftValue

FILETIME 結構。

備註

在 Internet Explorer 5 中，只有 InternetQueryOption 和 InternetSetOption 的 ANSI 版本才能使用 INTERNET_PER_CONN_OPTION 結構。 Unicode 版本將支援 Internet Explorer 更新版本中 的 INTERNET_PER_CONN_OPTION 結構。

對於傳回字串的查詢， InternetQueryOption 會為結構的 pszValue 成員配置記憶體。呼叫的應用程式在使用字串完成時，必須使用 GlobalFree 函式釋放此記憶體。

注意 WinINet 不支援伺服器實作。此外，它不應該從服務使用。對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。

注意

wininet.h 標頭會將INTERNET_PER_CONN_OPTION定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

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

另請參閱

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption

共用方式為