勇芳软件工作室.汉化:  WinHTTP Reference > WinHTTP Interfaces > IWinHttpRequest >

SetProxy Method

Previous pageReturn to chapter overviewNext page

描述

 

设置代理服务器信息。

 

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)。