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. |
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 IBindStatusCallbackwould register itself for proxy information in this manner:
Copy Code | |
---|---|
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 dwOptionparameter set to either pioHTTPPROXY or pioWAPGATEWAY, and the pBufferpointing to either an HTTPPROXYINFOor WAPGATEWAYINFOstructure, 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 BindStatusCallbackfunction can register with the download request BindCtxto 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 IProxyInfoyou should call RegisterObjectParamon the BindCtxof 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 |