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 文件。
值 | 含义 |
---|---|
|
通过自动配置 URL 启用代理检测。
注意Windows 10版本 1703 (10.0 中引入了对此标志的支持;内部版本 15063) 。 |
|
通过连接管理器启用代理检测。
注意Windows 10版本 1703 (10.0 中引入了对此标志的支持;内部版本 15063) 。 |
|
通过静态配置启用代理检测。
注意Windows 10版本 1703 (10.0 中引入了对此标志的支持;内部版本 15063) 。 |
|
尝试使用对本地网络的 DHCP 和 DNS 查询自动发现 PAC 文件的 URL。 |
|
从 WINHTTP_AUTOPROXY_OPTIONS 结构中的 lpszAutoConfigUrl 指定的 URL 下载 PAC 文件。 |
|
维护传递给 PAC 脚本的主机名大小写。 这是默认行为。 |
|
将主机名转换为小写,然后再将其传递给 PAC 脚本。 |
|
禁用在当前进程中查询脚本执行结果的主机到代理缓存。 |
|
禁用在 autoproxy 服务中查询脚本执行结果的主机到代理缓存。 |
|
禁用查询此请求的直接访问代理设置。 |
|
在进程内执行 Web 代理自动发现 (WPAD) 协议,而不是委托给进程外 WinHTTP AutoProxy 服务(如果可用)。 此标志必须与其他标志之一结合使用。
此选项在传递给 WinHttpGetProxyForUrlEx 时无效。 注意 此标志已弃用。
|
|
默认情况下,WinHTTP 配置为回退以自动发现进程内的代理。 如果此回退行为在进程外发现失败时不可取,则可以使用此标志将其禁用。
此选项在传递给 WinHttpGetProxyForUrlEx 时无效。 注意 此标志仅在 Windows Server 2003 上可用。
|
|
根据先放置最快代理的试探法对代理结果进行排序。 |
dwAutoDetectFlags
如果 dwFlags 包含 WINHTTP_AUTOPROXY_AUTO_DETECT 标志,则 dwAutoDetectFlags 将指定用于查找 PAC 文件的协议。 如果同时指定了 DHCP 和 DNS 自动检测标志,则首先使用 DHCP;如果使用 DHCP 未发现 PAC URL,则使用 DNS。
如果 dwFlags 不包括 WINHTTP_AUTOPROXY_AUTO_DETECT 标志,则 dwAutoDetectFlags 必须为零。
值 | 含义 |
---|---|
|
使用 DHCP 查找代理自动配置文件。 |
|
使用 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 |