IProxyInfo::QueryInfo

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 BindStatusCallback function can register with the download request BindCtx to 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

See Also

Reference

IProxyInfo