描述
WinHttpGetIEProxyConfigForCurrentUser功能检索当前用户的Internet Explorer代理配置。
C / C ++语法
BOOL WinHttpGetIEProxyConfigForCurrentUser( WINHTTP_CURRENT_USER_IE_PROXY_CONFIG* pProxyConfig ); |
PowerBASIC 语法
FUNCTION WinHttpGetIEProxyConfigForCurrentUser ( _ pProxyConfig AS WINHTTP_CURRENT_USER_IE_PROXY_CONFIG _ ) AS LONG |
参数
pProxyConfig
[in, out]输入到WINHTTP_CURRENT_USER_IE_PROXY_CONFIG结构的指针。在输出上,该结构包含当前活动网络连接的Internet Explorer代理设置(例如LAN,拨号或VPN连接)。
返回值
如果函数成功,则返回TRUE,否则返回FALSE。要获取扩展错误信息,请调用GetLastError.返回的错误代码有:
错误代码 |
描述 |
ERROR_FILE_NOT_FOUND |
不能找到Internet Explorer代理设置。 |
ERROR_WINHTTP_INTERNAL_ERROR |
发生内部错误。 |
ERROR_NOT_ENOUGH_MEMORY |
没有足够的内存来完成请求的操作。(Windows错误代码) |
备注
在Internet Explorer中,代理设置可在工具/ 互联网选项菜单选项的连接选项卡上找到。代理设置是基于每个连接配置的;也就是说,LAN连接的代理设置与拨号或VPN连接的代理设置分开。WinHttpGetIEProxyConfigForCurrentUser返回当前活动连接的代理设置。
此函数对于在不实现Web代理自动发现(WPAD)协议的网络环境中运行的客户端应用程序(意味着没有代理自动配置文件可用)中非常有用。如果PAC文件不可用,则WinHttpGetProxyForUrl功能失败。WinHttpGetIEProxyConfigForCurrentUser功能可用作后台机制,通过在Internet Explorer中检索用户’的代理配置来发现可运行的代理配置。
不应在不模拟登录用户的服务进程中使用此函数。如果呼叫者没有模拟登录用户,则WinHTTP会尝试检索当前服务进程的Internet Explorer设置:例如本地服务或网络服务。如果未为这些系统帐户配置Internet Explorer设置,则调用WinHttpGetIEProxyConfigForCurrentUser将失败。
如果lpszProxy,lpszProxyBypass和lpszAutoConfigUrl字符串非NULL,则呼叫者必须使用lpszProxy和lpszAutoConfigUrl字符串。使用GlobalFree释放字符串。