IWMSIPAdmin.AccessListOptions (Visual Basic .NET)

  • Article

banner art

Previous Next

IWMSIPAdmin.AccessListOptions (Visual Basic .NET)

The AccessListOptions property specifies and retrieves an enumeration value indicating the default access permissions for unspecified IP addresses.

Syntax

  IWMSIPAdmin
  .AccessListOptions = WMS_IP_ACCESS_OPTIONS
WMS_IP_ACCESS_OPTIONS = IWMSIPAdmin.AccessListOptions

Property Value

A member of a WMS_IP_ACCESS_OPTIONS enumeration type indicating default access permissions for unspecified IP addresses. This must be one of the following values.

Value Description
WMS_IP_ACCESS_ALLOW_AND_DISALLOW Unspecified IP addresses are ignored.
WMS_IP_ACCESS_ALLOW_BY_DEFAULT Unspecified IP addresses are authorized by default.
WMS_IP_ACCESS_DISALLOW_BY_DEFAULT Unspecified IP addresses are rejected by default.

If this property fails, it throws an exception.

Number Description
0x80070057 The value you specified does not contain a member of the WMS_IP_ACCESS_OPTIONS enumeration type.

Example Code

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

Private Sub SetACLOptions()

    ' Declare variables.
    Dim Server As WMSServer
    Dim Plugin As IWMSPlugin
    Dim IPAdmin As IWMSIPAdmin

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

    ' Retrieve the plug-in to be configured.
    Plugin = Server.EventHandlers.Item("WMS IP Address Authorization")

    ' Retrieve the custom interface of the plug-in.
    IPAdmin = Plugin.CustomInterface

    ' Configure the plug-in to allow all IP addresses
    ' except those specifically set to deny.
    IPAdmin.AccessListOptions = WMS_IP_ACCESS_OPTIONS.WMS_IP_ACCESS_ALLOW_BY_DEFAULT

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