Share via

IWMSServerPeakCounters.ConnectedPlayers (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSServerPeakCounters.ConnectedPlayers (Visual Basic .NET)

The ConnectedPlayers property retrieves the maximum number of players that have simultaneously connected to the server since the last reset.

Syntax

  Integer = IWMSServerPeakCounters.ConnectedPlayers

Property Value

Integer containing the peak number of connected players.

Remarks

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 level 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.

You can use the IWMSServerPeakCounters.Reset method to reset the parameter to the current value.

Example Code

Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices

Private Sub CountConnectedPlayers()

    ' Declare variables.
    Dim Server As WMSServer
    Dim PeakCounters As IWMSServerPeakCounters
    Dim iValue As Integer

Try
    ' Create the WMSServer object.
    Server = New WMSServer()

    ' Retrieve a list of peak statistics
    ' for the server.
    PeakCounters = Server.PeakCounters

    ' Retrieve the maximum concurrently connected
    ' clients since the start time.
    iValue = PeakCounters.ConnectedPlayers

Catch excCom As COMException
    ' TODO: Handle COM exceptions.
Catch exc As Exception
    ' TODO: Handle errors.
Finally
    ' TODO: Clean-up code goes here.
End Try

End Sub

Requirements

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