Share via

IWMSServerLimits::put_ConnectedPlayers

  • Article

banner art

Previous Next

IWMSServerLimits::put_ConnectedPlayers

The put_ConnectedPlayers method specifies the maximum number of players that can be simultaneously connected to the server.

Syntax

  HRESULT put_ConnectedPlayers(
  long  newVal
);

Parameters

newVal

[in] long containing the number of player connections permitted. If you specify a value of –1, there is no limit on the number of player connections.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code Number Description
E_INVALIDARG 0x80070057 Indicates that newVal is not a valid 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::put_OutgoingDistributionConnections method 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

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

Requirements

Header: wmsserver.h.

Library: WMSServerTypeLib.dll.

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

See Also

Previous Next