Resets a user's password to a new, automatically generated password.
Namespace:
Novalys.VisualGuard.SecurityAssembly: 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
Exception | Condition |
---|---|
System..::.ArgumentNullException |
The name is null. orThe passwordAnswer is null and RequiresQuestionAndAnswer is set to true. |
System..::.ArgumentException |
The name or passwordAnswer is longer than 64 characters orThe name is empty. |
Novalys.VisualGuard.Security.Membership..::.VGMembershipPasswordException | passwordAnswer 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. |