winhttp.h) WINHTTP_AUTOPROXY_OPTIONS结构 (

  • 项目

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 文件。

Value 含义
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 通过自动配置 URL 启用代理检测。
WINHTTP_AUTOPROXY_ALLOW_CM
 通过连接管理器启用代理检测。
WINHTTP_AUTOPROXY_ALLOW_STATIC
 通过静态配置启用代理检测。
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 必须为零。

Value 含义
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、具有 SP3 的 Windows 2000 Server [仅限桌面应用]
标头 winhttp.h

另请参阅

WinHTTP 版本