Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Retrieves the specified proxy or gateway information for a binding operation.

Syntax

HRESULT QueryInfo(
  DWORD 
dwOption,
  LPVOID 
pBuffer,
  DWORD * 
pcbBuf,
  DWORD * 
pdwFlags,
  DWORD * 
pdwReserved
);

Parameters

dwOption

[in] Unsigned long integer value that indicates the information to be queried. This argument is one of the PROXYINFOOPTION flags (pioHTTPPROXY or pioWAPGATEWAY).

pBuffer

[in, out] Address of the buffer that contains the HTTP proxy ( HTTPPROXYINFO) or WAP gateway ( WAPGATEWAYINFO) information, depending on the value of dwOption.

pcbBuf

[in, out] Address of an unsigned long integer variable to store the size of the requested information.

pdwFlags

[in, out] Unused. Set to 0.

pdwReserved

[in, out] Reserved. Set to 0.

Return Value

If the client wishes to use a proxy and was able to successfully set the proxy information, it should return S_OK. If the client does not want to use a proxy or could not set the information, this method returns a failing HRESULT. In this case, Urlmon will not try to use a proxy.

Remarks

A BindStatusCallbackfunction can register with the download request BindCtxto set HTTP proxy and WAP gateway settings. This function will be called when the binding operation requires proxy or gateway information.

The strings returned in the proxy/gateway information structures must be allocated by using the CoTaskMemAlloc()function.

Requirements

Header urlmon.h
Library urlmon.lib
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

IProxyInfo