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 (C#)
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 that are 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
using Microsoft.WindowsMediaServices.Interop;
using System.Runtime.InteropServices;
// Retrieve the IWMSPlugins interface
// containing authentication plug-ins.
Plugins = Server.Authenticators;
}
catch (COMException comExc) {
// TODO: Handle COM exceptions.
}
catch (Exception e) {
// TODO: Handle exceptions.
}
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 |