WinHttpGetIEProxyConfigForCurrentUser 函数 (winhttp.h)

WinHttpGetIEProxyConfigForCurrentUser 函数检索当前用户的 Internet Explorer 代理配置。

语法

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

参数

[in, out] pProxyConfig

输入上的指针，指向 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 结构。 在输出中，结构包含当前活动网络连接的 Internet Explorer 代理设置， (例如 LAN、拨号或 VPN 连接) 。

返回值

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

注解

在 Internet Explorer 中，代理设置位于“工具 / Internet 选项”菜单选项选项的“连接”选项卡上。 基于每个连接配置代理设置;也就是说，LAN 连接的代理设置与拨号或 VPN 连接的代理设置是分开的。 WinHttpGetIEProxyConfigForCurrentUser 返回当前活动连接的代理设置。

此函数在网络环境中运行的客户端应用程序非常有用，其中 Web 代理自动发现 (WPAD) 协议未实现， (这意味着) 没有可用的代理自动配置文件。 如果 PAC 文件不可用，则 WinHttpGetProxyForUrl 函数失败。 WinHttpGetIEProxyConfigForCurrentUser 函数可用作回退机制，通过在 Internet Explorer 中检索用户的代理配置来发现可行的代理配置。

不应在不模拟已登录用户的服务进程中使用此函数。如果调用方未模拟登录用户，WinHTTP 会尝试检索当前服务进程的 Internet Explorer 设置：例如，本地服务或网络服务。 如果未为这些系统帐户配置 Internet Explorer 设置，则对 WinHttpGetIEProxyConfigForCurrentUser 的 调用将失败。

调用方必须在 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 结构中释放 lpszProxy、lpszProxyBypass 和 lpszAutoConfigUrl 字符串（如果它们不是 NULL）。 使用 GlobalFree 释放字符串。

要求

另请参阅

WinHTTP 版本