IWMSServer.Authenticators (C#)

  • Article

banner art

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