Share via

IWMSProxyContext::FindProxyForURL

  • Article

banner art

Previous Next

IWMSProxyContext::FindProxyForURL

The FindProxyForURL method retrieves the name and port number of an upstream proxy server. This method is called by the server and implemented by the plug-in.

Syntax

Parameters

pUserContext

[in] Pointer to an IWMSContext interface containing the user context.

bstrURL

[in] BSTR containing the URL of the requested content on an upstream server.

pbstrProxyServer

[out] Pointer to a BSTR that contains the name of the proxy server that must be used to contact the origin server.

pdwProxyPort

[out] Pointer to a DWORD that contains the port number of the upstream proxy server. This port must be appropriate for the protocol identified by the bstrProtocol parameter.

Return Values

If the method succeeds, the plug-in must return S_OK. To report an error, the plug-in can return any HRESULT other than S_OK. If the plug-in uses the IWMSEventLog interface to log error information directly to the Windows Event Viewer, it is recommended that it return NS_E_PLUGIN_ERROR_REPORTED. Typically, the server attempts to make plug-in error information available to the server object model, the Windows Event Viewer, and the troubleshooting list in the details pane of the Windows Media Services MMC. However, if the plug-in uses the IWMSEventLog interface to send custom error information to the Windows Event Viewer, returning NS_E_PLUGIN_ERROR_REPORTED stops the server from also logging to the event viewer. For more information about retrieving plug-in error information, see Identifying Plug-in Errors.

Return code Description
S_FALSE Instructs the server to use the default proxy settings specified in the WMS Network Data Source plug-in. The server uses the default settings for any error code other than S_OK.
S_OK The plug-in can indicate which proxy to use by returning S_OK and setting pbstrProxyServer and pdwProxyPort. The plug-in can indicate that a proxy should not be used by returning S_OK and setting pbstrProxyServer to NULL or to an empty string.

Requirements

Header: wmsproxy.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next