IWMSPublishingPointTotalCounters Interface

  • Article

banner art

Previous Next

IWMSPublishingPointTotalCounters Interface

You can use the IWMSPublishingPointTotalCounters interface to retrieve totals for the number of connections to the server and the amount of bandwidth allocated to the connections.

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

Method Description
get_Advertisements Retrieves the cumulative number of advertisements that have been streamed from playlists since the last reset.
get_AllCounters Retrieves an array that contains all of the counters supported by the interface.
get_ConnectedPlayers Retrieves the total number of players connected to the publishing point since the last reset.
get_CountersStartTime Retrieves the date and time at which the publishing point started monitoring the total counters.
get_FileBytesRead Retrieves the total number of bytes read from the publishing point since the last reset.
get_LateReads Retrieves the total number of read operations that took over 400 milliseconds.
get_OutgoingDistributionBytesSent Retrieves the total number of bytes sent to distribution connections since the last reset.
get_OutgoingDistributionConnections Retrieves the total number of distribution connections established since the last reset.
get_PlayerBytesSent Retrieves the total number of bytes sent to players since the last reset.
get_StreamDenials Retrieves the total number of stream transmissions denied since the last reset.
get_StreamErrors Retrieves the total number of dropped-packet errors since the last reset.
get_StreamingPlayers Retrieves the total number of players that have streamed data from the publishing point since the last reset.
get_StreamingHTTPPlayers Retrieves the total number of players that have streamed data by using the HTTP protocol from the publishing point since the last reset.
get_StreamingRTSPPlayers Retrieves the total number of players that have streamed data by using the RTSP protocol from the publishing point since the last reset.
get_StreamingUDPPlayers Retrieves the total number of players that have streamed data by using the User Datagram Protocol (UDP) from the publishing point since the last reset.
get_StreamTerminations Retrieves the total number of stream transmissions that have been terminated since the last reset.
Reset Resets the counters to the current values.

Example Code

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

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

// Declare variables and interfaces.
IWMSServer                          *pServer;
IWMSPublishingPoints                *pPubPoints;
IWMSPublishingPoint                 *pPubPoint;
IWMSPublishingPointTotalCounters    *pTotalCounters;

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;



hr = pServer->get_PublishingPoints(&pPubPoints);
if (FAILED(hr)) goto EXIT;
hr = pPubPoints->get_Count(&lCount);
if (FAILED(hr)) goto EXIT;

// Retrieve information about each publishing point.
for (long x = 0; x < lCount; x++)
{
    varIndex = x;
    hr = pPubPoints->get_Item(varIndex, &pPubPoint);
    if (FAILED(hr)) goto EXIT;

    // Retrieve a pointer to a list of total statistics
    // for the publishing point.
    hr = pPubPoint->get_TotalCounters(&pTotalCounters);
    if (FAILED(hr)) goto EXIT;

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

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

See Also

Previous Next