IWMSInternalAdminNetSource3::FindProxyForURLEx2 method (wmsinternaladminnetsource.h)
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The FindProxyForURLEx2 method finds a proxy server name and port to use for the user.
Syntax
HRESULT FindProxyForURLEx2(
[in] BSTR bstrProtocol,
[in] BSTR bstrHost,
[in] BSTR bstrUrl,
[out] BOOL *pfProxyEnabled,
[out] BSTR *pbstrProxyServer,
[out] DWORD *pdwProxyPort,
[in, out] QWORD *pqwProxyContext
);
Parameters
[in] bstrProtocol
String containing the protocol for which to find the proxy server. Typically, this is either "http" or "mms".
[in] bstrHost
String containing the DNS name, or IP address, of the server with which you want to communicate. Depending upon the server, the proxy might be different.
[in] bstrUrl
String containing the full URL of the site to which you want to connect.
[out] pfProxyEnabled
Pointer to a Boolean value that is set to True if the user has enabled a proxy that applies to the specified protocol, host, and site.
[out] pbstrProxyServer
Pointer to a string containing the proxy server DNS name.
[out] pdwProxyPort
Pointer to a DWORD containing the proxy port number.
[in, out] pqwProxyContext
QWORD representing the proxy server returned. You can make multiple calls to FindProxyForURL to find all configured proxy servers. On your first call, set the context to zero. When the call returns, the context is set to a value representing the proxy for which information was returned. On the next call, set the context to the context value retrieved on the first call. Continue this process until the call returns S_FALSE.
This method has internal algorithms that determine how it looks for proxy servers. You can override this and make it find the proxy server set by the client's Web browser, by setting the context to 3.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
When calling this method multiple times to find all proxies configured, this value is returned when there are no more configured proxy servers. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 9 Series SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wmsinternaladminnetsource.h |
| Library | Wmvcore.lib; WMStubDRM.lib (if you use DRM) |