Share via

IWMSServer::get_ControlProtocols

  • Article

banner art

Previous Next

IWMSServer::get_ControlProtocols

The get_ControlProtocols method retrieves an IWMSPlugins interface containing a collection of control protocol plug-ins that can be used to interpret and respond to client requests.

Syntax

  HRESULT get_ControlProtocols(
  IWMSPlugins**  pVal
);

Parameters

pVal

[out] Pointer to a pointer to the IWMSPlugins interface containing the collection of control protocol plug-ins.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Number Description
E_POINTER 0x80004003 Indicates that pVal is a NULL pointer argument.

Remarks

This method calls AddRef internally. To avoid memory leaks, you must call Release when you are finished using the interface.

Plug-ins included with Windows Media Services support the RTSP, HTTP, and MMS protocols.

The following system plug-ins can be accessed by using the get_ControlProtocols method.

Plug-in Description
WMS HTTP Server Control Protocol Enables a Windows Media server to communicate with clients by using the HTTP protocol.
WMS MMS Server Control Protocol Enables a Windows Media server to communicate with clients by using the MMS protocol.
WMS RTSP Server Control Protocol Enables a Windows Media server to communicate with clients by using the RTSP protocol.

In Windows Server 2008 operating systems, the MMS protocol is not supported, and Windows Media Services does not provide an MMS Server Control Protocol plug-in.

Example Code

#include <windows.h>
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer      *pServer;
IWMSPlugins     *pPlugins;

HRESULT         hr;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer,
                      NULL,
                      CLSCTX_ALL,
                      IID_IWMSServer,
                      (void **)&pServer);
if (FAILED(hr)) goto EXIT;

// Retrieve a pointer to an IWMSPlugins interface
// containing control protocol plug-ins.
hr = pServer->get_ControlProtocols(&pPlugins);
if (FAILED(hr)) goto EXIT;

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003 family, Windows Server 2008 family.

See Also

Previous Next