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. |
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 |