IWMSServerLimits Interface

You can use the IWMSServerLimits interface to specify and retrieve the maximum bandwidth and number of connections supported by the server.

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

Method

Description

get_ConnectedPlayers

Retrieves the largest number of players that can be simultaneously connected to the server.

get_ConnectionRate

Retrieves the maximum rate of client connections permitted by the server.

get_CPUUtilizationDuringConnection

Retrieves the maximum CPU utilization permitted before new client connections to the server are denied.

get_DiagnosticEvents

Retrieves the maximum number of IWMSDiagnosticEvent objects that a specific IWMSDiagnosticEvents collection can contain.

get_IncomingBandwidth

Retrieves the maximum bandwidth allocated by the server for incoming connections.

get_OutgoingDistributionBandwidth

Retrieves the maximum total distribution bandwidth permitted by the server.

get_OutgoingDistributionConnections

Retrieves the maximum number of distribution connections permitted by the server.

get_PerOutgoingDistributionConnectionBandwidth

Retrieves the maximum bandwidth permitted for a single distribution connection.

get_PerPlayerConnectionBandwidth

Retrieves the maximum bandwidth permitted for a single player connection.

get_PlayerAcknowledgementTimeout

Retrieves the maximum length of time, in milliseconds, that a client is allowed to remain connected if the server has not received a client request.

get_PlayerBandwidth

Retrieves the maximum total player bandwidth permitted by the server.

get_PlayerInactivityTimeout

Retrieves the maximum length of time that a player is permitted to remain connected without receiving streamed content.

put_ConnectedPlayers

Specifies the largest number of players that can be simultaneously connected to the server.

put_ConnectionRate

Specifies the maximum rate of client connections permitted by the server.

put_CPUUtilizationDuringConnection

Specifies the maximum CPU utilization permitted before new client connections to the server are denied.

put_DiagnosticEvents

Specifies the maximum number of IWMSDiagnosticEvent objects that a specific IWMSDiagnosticEvents collection can contain.

put_IncomingBandwidth

Specifies the maximum bandwidth allocated by the server for incoming connections.

put_OutgoingDistributionBandwidth

Specifies the maximum total distribution bandwidth permitted by the server.

put_OutgoingDistributionConnections

Specifies the maximum number of distribution connections permitted by the server.

put_PerOutgoingDistributionConnectionBandwidth

Specifies the maximum bandwidth permitted for a single distribution connection.

put_PerPlayerConnectionBandwidth

Specifies the maximum bandwidth permitted for a single player connection.

put_PlayerAcknowledgementTimeout

Specifies the maximum length of time, in milliseconds, that a client is allowed to remain connected if the server hasn't received a client request.

put_PlayerBandwidth

Specifies the maximum total player bandwidth permitted by the server.

put_PlayerInactivityTimeout

Specifies the maximum length of time that a player is permitted to remain connected without receiving streamed content.

Example

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

#include <windows.h>
#include "wmsserver.h"

// Declare variables and interfaces.
IWMSServer          *pServer;
IWMSServerLimits    *pLimits;

HRESULT         hr;

// 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;

// Retrieve a pointer to the IWMSServerLimits
// interface for the server.
hr = pServer->get_Limits(&pLimits);
if (FAILED(hr)) goto EXIT;

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

See Also

Reference

IWMSServer Interface

Concepts

Server Object Model Interfaces (C++)