Share via

IWMSPlayer Interface

  • Article

banner art

Previous Next

IWMSPlayer Interface

You can use the IWMSPlayer interface to retrieve properties for a specific player.

In addition to the methods inherited from IDispatch, the IWMSPlayer interface exposes the following methods.

Method Description
get_ID Retrieves a unique value that identifies a player that is receiving content from the server.
get_NetworkAddress Retrieves the network address of the client that is receiving content from the server.
get_Port Retrieves the port number of the client receiving content from the server.
get_RequestedPlaylist Retrieves an IWMSPlaylist interface for the client.
get_RequestedURL Retrieves the URL that the player used to request a connection.
get_ResolvedURL Retrieves the URL of the content that is being streamed to the player.
get_Status Retrieves the status of the player.
get_UserName Retrieves the name of the authenticated player.
get_WrapperPlaylist Retrieves a wrapper playlist object.
  • Note   If you call the Release method of an IWMSPlayer interface on which the associated client connection is using an HTTP connection, it can cause the server to indicate the client status as disconnected for a minute or two, although the client will continue to stream content. This is expected behavior, caused by the nature of the HTTP/1.0 protocol.

Example Code

The following example illustrates how to retrieve a pointer to an IWMSPlayer interface.

#include <windows.h>
#include <atlbase.h>    // Includes CComVariant.
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer      *pServer;
IWMSPlayers     *pPlayers;
IWMSPlayer      *pPlayer;

HRESULT         hr;
CComVariant     varIndex;
long            lCount;

// 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 IWMSPlayers interface
// and retrieve the total count of current connections.
hr = pServer->get_Players(&pPlayers);
if (FAILED(hr)) goto EXIT;
hr = pPlayers->get_Count(&lCount);
if (FAILED(hr)) goto EXIT;

// Retrieve information about each client connection.
for (long x = 0; x < lCount; x++)
{
    varIndex = x;
    hr = pPlayers->get_Item(varIndex, &pPlayer);
    if (FAILED(hr)) goto EXIT;

    // Release temporary COM objects.
    pPlayer->Release();
}

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

See Also

Previous Next