IWMSServerLimits.OutgoingDistributionConnections (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSServerLimits.OutgoingDistributionConnections (Visual Basic .NET)

The OutgoingDistributionConnections property specifies and retrieves the maximum number of distribution connections permitted by the server.

Syntax

  IWMSServerLimits
  .OutgoingDistributionConnections = Integer
Integer = IWMSServerLimits.OutgoingDistributionConnections

Property Value

Integer containing the number of permitted connections. By default, the value of the property is –1, indicating that there is no limit on the number of connections.

If this property fails, it returns an error number.

Number Description
0x80070057 Integer is an invalid argument.

Remarks

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

Example Code

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

Private Sub GetSetConnectionCount()

    ' Declare variables.
    Dim Server As WMSServer
    Dim Limits As IWMSServerLimits
    Dim iValue As Integer

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

    ' Retrieve the IWMSServerLimits object for the server.
    Limits = Server.Limits

    ' Retrieve the limit for concurrently connected
    ' distribution connections.
    iValue = Limits.OutgoingDistributionConnections

    ' Set the limit for concurrently connected
    ' distribution connections.
    Limits.OutgoingDistributionConnections = 50

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