ClientWindowsAuthenticationMembershipProvider Class

Definition

public ref class ClientWindowsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientWindowsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientWindowsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientWindowsAuthenticationMembershipProvider
Inherits MembershipProvider

Inheritance

Object

ProviderBase

MembershipProvider

ClientWindowsAuthenticationMembershipProvider

Examples

The following example code demonstrates how to use this method to authenticate a user by using Windows authentication. In this example, the value of the static Membership.Provider property is cast to a ClientWindowsAuthenticationMembershipProvider instance. This makes sure that a NullReferenceException will be thrown if you accidentally test this code by using another membership provider.

private bool ValidateUsingWindowsAuthentication()
{
    ClientWindowsAuthenticationMembershipProvider authProvider =
        System.Web.Security.Membership.Provider as
        ClientWindowsAuthenticationMembershipProvider;

    // Call ValidateUser and pass null values for the parameters.
    // This call always returns true.
    return authProvider.ValidateUser(null, null);
}

Private Function ValidateUsingWindowsAuthentication() As Boolean

    Dim authProvider As ClientWindowsAuthenticationMembershipProvider = _
        CType(System.Web.Security.Membership.Provider,  _
        ClientWindowsAuthenticationMembershipProvider)

    ' Call ValidateUser and pass Nothing for the parameters.
    ' This call always returns true.
    Return authProvider.ValidateUser(Nothing, Nothing)

End Function

Remarks

You can use client application services to validate users by using Windows authentication. To enable Windows authentication, you configure your application to use the ClientWindowsAuthenticationMembershipProvider class.

After configuration, you can validate users by calling the static Membership.ValidateUser method. The Membership.ValidateUser method internally calls the ValidateUser method.

The ClientWindowsAuthenticationMembershipProvider.ValidateUser method automatically authenticates the current user and sets the static Thread.CurrentPrincipal property to a ClientRolePrincipal object that contains the current WindowsIdentity. If a ClientRoleProvider is configured for your application, you can use the ClientRolePrincipal object to retrieve user role information from the roles service.

You can retrieve a reference to the current ClientWindowsAuthenticationMembershipProvider instance through the static Membership.Provider property. You can use the membership provider reference to call the ClientWindowsAuthenticationMembershipProvider.ValidateUser method directly. Additionally, you will need the membership provider reference to call the Logout method, which is not available in the MembershipProvider base class.

Constructors

Properties

Methods

Events

Applies to

See also

• ValidateUser(String, String)
• ValidateUser(String, String)
• CurrentPrincipal
• ClientRolePrincipal
• WindowsIdentity
• ClientRoleProvider
• Provider
• Logout()
• Client Application Services
• How to: Configure Client Application Services