Visual Guard Class Library Documentation

VGHttpModule.Authenticate Method 

Authenticates a user for the specified HttpContext.

public VGAuthenticationState Authenticate(
   HttpContext context,
   String name,
   String password,
   VGAuthenticationMode mode
);

Parameters

context
A valid HttpContext representing the context for which the security is loaded.
name
the name of the user.
password
the password of the given user.
mode
A VGAuthenticationMode indicating the mode of authentication used to authenticate the user

Return Value

A VGAuthenticationState indicating if the authentication succeeds or not.

Remarks

This method will replace the User property. When the authentication fails, the User property is set to null. For more information about this method, you can see Authenticate.

Exceptions

Exception Type Condition
ArgumentException The value of mode is equal to None or is a combination of several modes.

- or-

the name is an empty string or is longer than 64 characters.

- or-

the password is longer than 64 characters.
ArgumentNullException The name or the password or context is null (Nothing in VB) and the mode is not Windows.
NotSupportedException

the repository does not support the specified authentication mode.

VGConfigurationException The configuration file is not valid

or

A problem occurs during the connection to the repository.

or

The version of the repository or the version of the permissions is not supported by the application.

See Also

VGHttpModule Class | Novalys.VisualGuard.Security.WebForm Namespace