IWMSServer.Authenticators (C#)
The Authenticators property retrieves an IWMSPluginsIWMSPlugins Object (C#) containing a collection of authentication plug-ins. You can use authentication plug-ins to establish the identity of clients that are requesting connections.
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
using Microsoft.WindowsMediaServices.Interop;
using System.Runtime.InteropServices;
// Declare variables.
WMSServer Server;
IWMSPlugins Plugins;
try {
// Create a new WMSServer object.
Server = new WMSServerClass();
// 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.