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

WinHttpGetDefaultProxyConfiguration

Previous pageReturn to chapter overviewNext page

描述

 

WinHttpGetDefaultProxyConfiguration函数从注册表中检索默认的WinHTTP代理配置。

 

C / C ++语法

 

BOOL WinHttpGetDefaultProxyConfiguration(

WINHTTP_PROXY_INFO* pProxyInfo

);

 

PowerBASIC 语法

 

FUNCTION WinHttpGetDefaultProxyConfiguration ( _

BYREF pProxyInfo AS WINHTTP_PROXY_INFO _

) AS LONG

 

参数

 

pProxyInfo

 

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

 

返回值

 

如果函数成功,则返回TRUE,否则返回FALSE。要获取扩展错误信息,请调用GetLastError.返回的错误代码有:

 

错误代码

描述

ERROR_WINHTTP_INTERNAL_ERROR

发生内部错误。

ERROR_NOT_ENOUGH_MEMORY

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

 

备注

 

WinHttpGetDefaultProxyConfiguration检索由WinHttpSetDefaultProxyConfiguration或ProxyCfg.exe设置的代理配置。

 

可以通过调用WinHttpSetOption并指定WINHTTP_OPTION_PROXY标志来覆盖WinHTTP会话的默认代理配置。WinHttpGetDefaultProxyConfiguration不检索当前会话的配置。它检索注册表中指定的配置。

 

如果注册表包含代理服务器列表,dwAccessTypepProxyInfo成员设置为WINHTTP_ACCESS_TYPE_NAMED_PROXY。否则,将其设置为WINHTTP_ACCESS_TYPE_NO_PROXY。

 

WinHttpGetDefaultProxyConfigurationpProxyInfo的字符串成员分配内存。要释放此内存,请调用GlobalFree.

 

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