Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
.gif)
| Previous | Next |
IWMSServer.Authenticators (Visual Basic .NET)
The Authenticators property retrieves an IWMSPlugins object containing a collection of authentication plug-ins. You can use authentication plug-ins to establish the identity of clients that are requesting connections.
Syntax
IWMSPlugins = IWMSServer.Authenticators
Property Value
An IWMSPlugins object containing the collection of authentication plug-ins.
Remarks
There is no limit to the number of plug-ins that can be in this collection. Authentication plug-ins can use any of the following methods to identify clients:
- The plug-in can request that the client supply a password and user name. The password can be encrypted or sent as clear text.
- The plug-in can identify the client based on logon credentials.
- The plug-in can ignore passwords, user names, and logon credentials.
If the plug-in is able to authenticate the client, it sends information about the client to the authorization plug-in to determine whether access permission can be granted.
The following system plug-ins can be accessed using the Authenticators property.
| Plug-in | Description |
| WMS Anonymous User Authentication | Enables an unauthenticated user to access content without being prompted for either a password or user name. The client is granted the same access permissions granted to the Windows user account specified in the property page for the plug-in. |
| WMS Digest Authentication | Prompts the client for a user name and password to verify identity. Because a hashed version of the password is used, Digest authentication is more secure than using Basic authentication, but not as secure as NTLM or Kerberos authentication. |
| WMS Negotiate Authentication | Supports both NTLM and Kerberos authentication protocols, and uses logon credentials to verify the identity of the client. The password is encrypted. |
To create custom authentication plug-ins, see Creating Authentication Plug-ins.
Example Code
Imports Microsoft.WindowsMediaServices.Interop
Imports System.Runtime.InteropServices
Private Sub GetAuthenticators()
' Declare variables.
Dim Server As WMSServer
Dim Plugins As IWMSPlugins
Try
' Create the WMSServer object.
Server = New WMSServer()
' Retrieve the IWMSPlugins interface
' containing authentication plug-ins.
Plugins = Server.Authenticators
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 |