描述
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。
WinHttpGetDefaultProxyConfiguration为pProxyInfo的字符串成员分配内存。要释放此内存,请调用GlobalFree.
即使在异步模式下使用WinHTTP(也就是说,当在WinHttpOpen中设置了WINHTTP_FLAG_ASYNC时),此函数同步运行。返回值表示成功或失败。要获取扩展错误信息,请调用GetLastError.