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