WINHTTP_PROXY_INFO結構 (winHTTP.h)

  • 發行項

WINHTTP_PROXY_INFO 結構包含會話或預設 Proxy 組態。

語法

typedef struct _WINHTTP_PROXY_INFO {
  DWORD  dwAccessType;
  LPWSTR lpszProxy;
  LPWSTR lpszProxyBypass;
} WINHTTP_PROXY_INFO, *LPWINHTTP_PROXY_INFO, *PWINHTTP_PROXY_INFO;

成員

dwAccessType

包含存取類型的無符號長整數值。 這個值可以是下列其中一個值：

值 意義
WINHTTP_ACCESS_TYPE_NO_PROXY
 透過直接連線存取因特網。
WINHTTP_ACCESS_TYPE_DEFAULT_PROXY
 僅適用於設定 Proxy 資訊時。
WINHTTP_ACCESS_TYPE_NAMED_PROXY
 使用 Proxy 存取因特網。

lpszProxy

包含 Proxy 伺服器清單的字串值指標。

lpszProxyBypass

包含 Proxy 略過清單的字串值指標。

備註

這個結構會與 WinHttpSetOption 和 WinHttpQueryOption 搭配使用，藉由指定WINHTTP_OPTION_PROXY旗標來取得或設定目前會話的 Proxy 組態。

此結構會與 WinHttpSetDefaultProxyConfiguration 和 WinHttpGetDefaultProxyConfiguration 搭配使用，以取得或設定登錄中的預設 Proxy 組態。

Proxy 伺服器清單包含下列一或多個以分號或空格符分隔的字串。

([<scheme>=][<scheme>"://"]<server>[":"<port>])

Proxy 略過清單包含一或多個以分號或空格符分隔的伺服器名稱。 Proxy 略過清單也可以包含字串 「<local>」，以指出會略過所有本機內部網路網站。 本機內部網路網站會被視為名稱中不包含句點的所有伺服器。

注意 針對 Windows XP 和 Windows 2000，請參閱 WinHttp 起始頁面的 運行時間需求 一節。
 

規格需求

需求 值
最低支援的用戶端 Windows XP、Windows 2000 Professional 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003、Windows 2000 Server 與 SP3 [僅限桌面應用程式]
標頭 winhttp.h
可轉散發套件 Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。

另請參閱

WinHTTP 版本