IWMSServerLimits.ConnectedPlayers (C#)

  • Article

banner art

Previous Next

IWMSServerLimits.ConnectedPlayers (C#)

The ConnectedPlayers property specifies and retrieves the largest number of players that can be simultaneously connected to the server.

Syntax

  IWMSServerLimits
  .ConnectedPlayers = int;
int = IWMSServerLimits.ConnectedPlayers;

Property Value

int containing the number of player connections permitted. If the value of the property is –1, there is no limit on the number of permitted player connections.

If this property fails, it throws an exception.

Number Description
0x80070057 int is an invalid argument.

Remarks

A player can bypass this limit by identifying itself as a distribution server. Therefore, it is recommended that you also use the IWMSServerLimits.OutgoingDistributionConnections property to specify the maximum number of distribution servers that can connect. A player can identify itself as a distribution server by changing its user agent. For more information about user agents, see Identifying a Cache Proxy Server.

Example Code

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











    // Retrieve the IWMSServerLimits object for the server.
    ServerLimits = Server.Limits;

    // Retrieve the limit for concurrently connected clients.
    iValue = ServerLimits.ConnectedPlayers;

    // Set the limit for concurrently connected clients.
    ServerLimits.ConnectedPlayers = 20;
}
catch (COMException comExc) {
    // TODO: Handle COM exceptions.
}
catch (Exception e) {
    // TODO: Handle exceptions.
}

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