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。
值 | 含义 |
---|---|
|
使用 DHCP 查找代理自动配置文件。 |
|
使用 DNS 尝试在本地计算机的域上的已知位置找到代理自动配置文件。 |
[out] ppwstrAutoConfigUrl
一种数据类型,返回指向以 null 结尾的 Unicode 字符串的指针,该字符串包含接收代理数据的配置 URL。 必须使用 GlobalFree 函数释放 ppwszAutoConfigUrl 指向的字符串。
返回值
如果成功,则返回 TRUE ,否则返回 FALSE 。 有关扩展的错误信息,请调用 GetLastError。 返回的错误代码如下。
错误代码 | 说明 |
---|---|
|
如果 WinHTTP 无法发现代理自动配置 (PAC) 文件的 URL,则返回。 |
|
发生了内部错误。 |
|
内存不足,无法完成请求的操作。 (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 |