IWMSPublishingPointPeakCounters.ConnectedPlayers (C#)

banner art

Previous Next

IWMSPublishingPointPeakCounters.ConnectedPlayers (C#)

The ConnectedPlayers property retrieves the maximum number of players that have been simultaneously connected to the publishing point.


  int = IWMSPublishingPointPeakCounters.ConnectedPlayers;

Property Value

int containing the maximum number of connected players.


This property is read-only. When clients request content from the server using HTTP 1.0, the peak connected players counter on both the server and publishing point levels may be incremented more than once for each client that connects to the server. This is a result of HTTP 1.0 being a connectionless protocol. As a result, the server does not maintain a persistent TCP control connection to the client. Each request from a client results in a new TCP connection to the server that cannot be associated with a specific client session. Because these requests may not be handled by the same thread, this can result in the peak and total connected counters being incremented more than once for a single request for content from a client.

Example Code

using Microsoft.WindowsMediaServices.Interop;
using System.Runtime.InteropServices;

// Declare variables.
WMSServer                            Server;
IWMSPublishingPoints                 PubPoints;
IWMSPublishingPoint                  PubPoint;
IWMSPublishingPointPeakCounters      PeakCounters;

int                                 iValue;

try {
    // Create a new WMSServer object.
    Server = new WMSServerClass();

    // Retrieve the IWMSPublishingPoints object.
    PubPoints = Server.PublishingPoints;

    // Retrieve information about each publishing point.
    for (int i = 0; i < PubPoints.Count; i++)
        PubPoint = PubPoints[i];

        // Retrieve a pointer to a list of peak statistics
        // for the publishing point.
        PeakCounters = PubPoint.PeakCounters;

        // Retrieve the peak number of connected players.
        iValue = PeakCounters.ConnectedPlayers;
catch (COMException comExc) {
    // TODO: Handle COM exceptions.
catch (Exception e) {
    // TODO: Handle exceptions.


Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

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

See Also

Previous Next