IWMSServerLimits Interface

banner art

Previous Next

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 Code

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

Previous Next