IWMSServer.Authenticators (C#)

  • Article

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.

See Also

Reference

IWMSPlugins Object (C#)

IWMSServer Object (C#)