描述
设置代理服务器信息。
C / C ++语法
HRESULT SetProxy( HTTPREQUEST_PROXY_SETTING ProxySetting, VARIANT varProxyServer, VARIANT varBypassList ); |
PowerBASIC 语法
METHOD SetProxy ( _ BYVAL ProxySetting AS LONG, _ OPTIONAL BYVAL varProxyServer AS VARIANT, _ OPTIONAL BYVAL varBypassList AS VARIANT _ ) |
参数
ProxySetting
[in]接收控制此方法的标志的LONG类型的值。可以是以下值之一。
值 |
含义 |
HTTPREQUEST_PROXYSETTING_DEFAULT |
默认代理设置。相当于HTTPREQUEST_PROXYSETTING_PRECONFIG。 |
HTTPREQUEST_PROXYSETTING_PRECONFIG |
表示代理设置应该从注册表获取。这假定Proxycfg.exe已经运行。如果Proxycfg.exe尚未运行,并且指定了HTTPREQUEST_PROXYSETTING_PRECONFIG,则该行为与HTTPREQUEST_PROXYSETTING_DIRECT相同。 |
HTTPREQUEST_PROXYSETTING_DIRECT |
表示所有HTTP和HTTPS服务器都应该直接访问。如果没有代理服务器,请使用此命令。 |
HTTPREQUEST_PROXYSETTING_PROXY |
当指定HTTPREQUEST_PROXYSETTING_PROXY时,应将varProxyServer设置为代理服务器字符串,并将varBypassList设置为域旁路列表字符串。此代理配置仅适用于WinHttpRequest对象的当前实例。 |
varProxyServer
[in, optional]当ProxySetting等于HTTPREQUEST_PROXYSETTING_PROXY时,设置为代理服务器字符串的Variant类型的值。
varBypassList
[in, optional]当ProxySetting等于HTTPREQUEST_PROXYSETTING_PROXY时,设置为域绕过列表字符串的Variant类型的值。
返回值
此方法不返回值。
OBJRESULT
如果成功返回S_OK,否则返回错误值。
备注
使呼叫应用程序指定使用默认代理信息(由代理配置工具配置)或覆盖Proxycfg.exe。调用Send方法前必须调用此方法。如果在发送方法之后调用此方法,则不起作用。
IWinHttpRequest将这些参数传递给Microsoft Windows HTTP服务(WinHTTP)。