ChangePassword Method

Changes the password, but only if the old password matches the user's current password.

Syntax

Sub ChangePassword(
    OldPassword As String,
    NewPassword As String)

Parameters

Oldpassword

The user's old password.

NewPassword

The user's new password.

Remarks

The password can consist of any Unicode characters. Once a new password has been set with the NewPassword Property, you can use the ChangePasswordMethod to change the user's password. The AllowChangePassword Property must be set to True. If the OldPassword parameter does not match the user's current password, then an error is returned.

If the user logs on to the system with Enterprise authentication, then password restrictions, such as the maximum length of the password string, are determined by the properties in the Crystal Enterprise secEnterprise PlugIn Library. Password restrictions for third-party accounts are set through your external systems.

Tip:    You can allow a logged on user to change his or her password through the current Enterprise session using the UserInfo object's Password Property.

Note:    You must have modify rights either by setting the role or by adding the security rights.

For a more comprehensive overview of the object security model used by Crystal Enterprise, see the Crystal Enterprise Administrator's Guide. See the "Appendix A: Object Rights and Access Levels" in the Crystal Enterprise Administrator's Guide for a list of the granular rights granted for each role.