IProxyInfo
4/8/2010
This is a callback interface that is used by urlmon to retrieve per-bind proxy information for HTTP, HTTPS, WSP, and WSPS transactions. Clients of URL monikers implement the interface. To advertise its presence, this interface must be registered with the bind context as an object named "_PROXYINFO_Holder_". For example, an object implementing IBindStatusCallback would register itself for proxy information in this manner:
m_pbc->RegisterObjectParam(OLESTR("_PROXYINFO_Holder_,
static_cast<IProxyInfo *>(this));
As the moniker begins to bind, the QueryInfo() method of this interface is called with the dwOption parameter set to either pioHTTPPROXY or pioWAPGATEWAY, and the pBuffer pointing to either an HTTPPROXYINFO or WAPGATEWAYINFO structure, respectively. If the client wants to use a proxy, such as for a WAP transaction or a WAP gateway, it must enter the members of the structure appropriately and return success. If no proxy or gateway is being used for the bind, the client should return E_FAIL.
A BindStatusCallback function can register with the download request BindCtx to set HTTP proxy and WAP gateway settings. This interface will be accessed when the binding operation requires proxy or gateway information. To register to supply IProxyInfo you should call RegisterObjectParam on the BindCtx of in the BindStatusCallback.
The following table shows the method of the IProxyInfo interface, with a description of its purpose.
| Method | Description |
|---|---|
Retrieves the specified proxy or gateway information for a binding operation |