WINHTTP_AUTOPROXY_OPTIONS结构 (winhttp.h)

WINHTTP_AUTOPROXY_OPTIONS 结构用于向 WinHttpGetProxyForURL 函数指示是指定代理自动配置 (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 启用代理检测。
 
注意Windows 10版本 1703 (10.0 中引入了对此标志的支持;内部版本 15063) 。
 
WINHTTP_AUTOPROXY_ALLOW_CM
通过连接管理器启用代理检测。
 
注意Windows 10版本 1703 (10.0 中引入了对此标志的支持;内部版本 15063) 。
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
通过静态配置启用代理检测。
 
注意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
禁用在当前进程中查询脚本执行结果的主机到代理缓存。
WINHTTP_AUTOPROXY_NO_CACHE_SVC
禁用在 autoproxy 服务中查询脚本执行结果的主机到代理缓存。
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
禁用查询此请求的直接访问代理设置。
WINHTTP_AUTOPROXY_RUN_INPROCESS
在进程内执行 Web 代理自动发现 (WPAD) 协议,而不是委托给进程外 WinHTTP AutoProxy 服务(如果可用)。 此标志必须与其他标志之一结合使用。

此选项在传递给 WinHttpGetProxyForUrlEx 时无效。

注意 此标志已弃用。
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
默认情况下,WinHTTP 配置为回退以自动发现进程内的代理。 如果此回退行为在进程外发现失败时不可取,则可以使用此标志将其禁用。

此选项在传递给 WinHttpGetProxyForUrlEx 时无效。

注意 此标志仅在 Windows Server 2003 上可用。
 
WINHTTP_AUTOPROXY_SORT_RESULTS
根据先放置最快代理的试探法对代理结果进行排序。

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 查找代理自动配置文件。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
使用 DNS 尝试在本地计算机的域上的已知位置找到代理自动配置文件。

lpszAutoConfigUrl

如果 dwFlags 包含 WINHTTP_AUTOPROXY_CONFIG_URL 标志, 则 lpszAutoConfigUrl 必须指向以 null 结尾的 Unicode 字符串,该字符串包含代理自动配置 (PAC) 文件的 URL。

如果 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 版本