WinHttpDetectAutoProxyConfigUrl 函数 (winhttp.h)

WinHttpDetectAutoProxyConfigUrl 函数查找代理自动配置 (PAC) 文件的 URL。 此函数报告 PAC 文件的 URL,但不下载该文件。

语法

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

参数

[in] dwAutoDetectFlags

一种数据类型,指定用于查找 PAC 文件的协议。 如果同时设置了 DHCP 和 DNS 自动检测标志,则首先使用 DHCP;如果使用 DHCP 未发现 PAC URL,则使用 DNS。

含义
WINHTTP_AUTO_DETECT_TYPE_DHCP
使用 DHCP 查找代理自动配置文件。
WINHTTP_AUTO_DETECT_TYPE_DNS_A
使用 DNS 尝试在本地计算机的域上的已知位置找到代理自动配置文件。

[out] ppwstrAutoConfigUrl

一种数据类型,返回指向以 null 结尾的 Unicode 字符串的指针,该字符串包含接收代理数据的配置 URL。 必须使用 GlobalFree 函数释放 ppwszAutoConfigUrl 指向的字符串。

返回值

如果成功,则返回 TRUE ,否则返回 FALSE 。 有关扩展的错误信息,请调用 GetLastError。 返回的错误代码如下。

错误代码 说明
ERROR_WINHTTP_AUTODETECTION_FAILED
如果 WinHTTP 无法发现代理自动配置 (PAC) 文件的 URL,则返回。
ERROR_WINHTTP_INTERNAL_ERROR
发生了内部错误。
ERROR_NOT_ENOUGH_MEMORY
内存不足,无法完成请求的操作。 (Windows 错误代码)

注解

WinHTTP 实现 Web 代理自动发现 (WPAD) 协议,通常称为 autoproxy。 有关已知位置的详细信息,请参阅 WPAD 协议文档的 发现过程 部分。

请注意,由于 WinHttpDetectAutoProxyConfigUrl 函数需要一段时间才能完成其操作,因此不应从 UI 线程调用它。

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional SP3 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003、Windows 2000 Server SP3 [仅限桌面应用]
目标平台 Windows
标头 winhttp.h
Library Winhttp.lib
DLL Winhttp.dll

另请参阅

WinHTTP 版本