描述
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.