Resets a user's password to a new, automatically generated password.

Namespace:  Novalys.VisualGuard.Security
Assembly:  Novalys.VisualGuard.Security (in Novalys.VisualGuard.Security.dll) Version: 3.2.912.1 (3.2.912.01)

Syntax

C#
public static string ResetPassword(
	string name,
	string passwordAnswer
)
Visual Basic (Declaration)
Public Shared Function ResetPassword ( _
	name As String, _
	passwordAnswer As String _
) As String

Parameters

name
Type: System..::.String
The name of the user to reset the password for.
passwordAnswer
Type: System..::.String
The password answer for the specified user.

Return Value

The new password for the specified user.

Remarks

The password answer check is case sensitive. We strongly recommend to store the password answer as a lowered string and provide a lowered value of the password answer when you want to reset the password by using the password question and answer.

CopyC#
<para>
  user.ChangePasswordQuestionAndAnswer(myPassword.Text, newPasswordQuestion.Text, newPasswordAnswer.Text.ToLowerInvariant())
  </para>
<para>
  user.ResetPassword(myPasswordAnswer.Text.ToLowerInvariant())
  </para>
CopyVB.NET
<para>
  user.ChangePasswordQuestionAndAnswer(myPassword.Text, newPasswordQuestion.Text, newPasswordAnswer.Text.ToLowerInvariant())
  </para>
<para>
  user.ResetPassword(myPasswordAnswer.Text.ToLowerInvariant())
  </para>

Exceptions

ExceptionCondition
System..::.ArgumentNullException

The name is null.

or

The passwordAnswer is null and RequiresQuestionAndAnswer is set to true.

System..::.ArgumentException

The name or passwordAnswer is longer than 64 characters

or

The name is empty.

Novalys.VisualGuard.Security.Membership..::.VGMembershipPasswordExceptionpasswordAnswer is invalid.

- or -

The user account is currently locked out or does not exist.

- or -

The generated password does not pass the password policy validation.
System..::.NotSupportedException

EnablePasswordReset is not set to true.

- Or -

the repository does not support Visual Guard authentication mode.

See Also