IProxyInfo::QueryInfo

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 Values

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 failed to set the information, this method returns a failing HRESULT, in which case Urlmon will not attempt to use a proxy.

Remarks

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

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

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib

Share via