This user control is primarily intended to be used by the ARWSLogonCtrl user control for changing expired passwords, however you can use this control separately in your application whenever you need to change user's password. It provides the following features:
- Checking user's login name and old (expired) password.
- Checking if it is allowed for the catalog to change expired passwords.
- Checking if the new password has the expected format, i.e. password policy.
- Checking if the account is not locked.
ARWSSetPassword User Control
How It Works
- The ARWSSetPasswordCtrl control is displayed in your application.
- User enters login name and old (expired) password.
- User enters a new password and its confirmation and clicks the "Set Password" button.
- The control connects to the SecureAccess WebService (via instance of the ARWSClient object), authenticates the user and tries to change the password.
- Based on the results of the authentication, the control performs the following actions:
If the password was changed successfully it raises the
that you can handle in your form (application)
If the provided login or old (expired) password are not valid, displays error message and raises the
that can be handled in your application.
- If the provided new password has not the format required by the password policy of the catalog it displays an error message and raises the ChangePasswordFailed event that can be handled in your application.
- If the password has been changed successfully the newly set password is available in the Password property.
How to Use the ARWSLogonCtrl into Your Form
Please see chapter Using Secure Access WinForms Controls - ARWSLogonCtrl and ARWSSetPasswordCtrl for a step-by-step guide on using the ARWSLogonCtrl in your applications.