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

WinHttpSetDefaultProxyConfiguration

Previous pageReturn to chapter overviewNext page

描述

 

WinHttpSetDefaultProxyConfiguration功能设置注册表中的默认WinHTTP代理配置。

 

C / C ++语法

 

BOOL WinHttpSetDefaultProxyConfiguration(

WINHTTP_PROXY_INFO* pProxyInfo

);

 

PowerBASIC 语法

 

FUNCTION WinHttpSetDefaultProxyConfiguration ( _

BYREF pProxyInfo AS WINHTTP_PROXY_INFO _

) AS LONG

 

参数

 

pProxyInfo

 

[in]指向类型为WINHTTP_PROXY_INFO的变量的指针,指定默认代理配置。

 

返回值

 

如果成功,返回一个有效的会话句柄,否则返回NULL。要检索扩展的错误信息,请调用GetLastError.返回的错误代码有:

 

错误代码

描述

ERROR_WINHTTP_INTERNAL_ERROR

发生内部错误。

ERROR_NOT_ENOUGH_MEMORY

没有足够的内存来完成请求的操作。(Windows错误代码)

 

备注

 

WinHttpSetDefaultProxyConfiguration更改ProxyCfg.exe设置的代理配置。

 

通过调用WinHttpSetOption并指定WINHTTP_OPTION_PROXY标志,可以通过此函数为现有WinHTTP会话覆盖默认代理配置。通过使用WinHttpOpen功能指定配置??,可以覆盖新会话的默认代理配置。

 

如果指定了代理,则WINHTTP_PROXY_INFO所指向的WINHTTP_PROXY_INFO结构的dwAccessType成员应设置为WINHTTP_ACCESS_TYPE_NAMED_PROXY。否则,应将其设置为WINHTTP_ACCESS_TYPE_DEFAULT_PROXY。

 

调用此函数后创建的任何新会话都使用新的默认代理配置。

 

即使在异步模式下使用WinHTTP(即在WinHttpOpen中设置了WINHTTP_FLAG_ASYNC)时,此函数也可以同步运行。返回值表示成功或失败。要获取扩展错误信息,请调用GetLastError.