ChangePassword Method

Change the mailbox password for the specified user.

Syntax

object.ChangePassword( Username, Oldpass, Newpass )

The ChangePassword method syntax has the following parts:

Part Description
object An object expression that evaluates to an InternetMail object.
username A string which specifies the username.
oldpass A string which specifies the old password.
newpass A string which specifies the new password.

Return Type

Integer

Remarks

The ChangePassword method changes the password that will be used to authenticate the specified user.

The Username argument specifies the username for the mailbox. If this is the same value as the UserName property, then successfully changing the password will cause the Password property to be updated with the new password.

The Oldpass argument specifies the current password for the user's mailbox. An error will be returned if this is an empty string.

The Newpass argument specifies the new password for the user's mailbox. An error will be returned if this is an empty string, or if the old and new password are the same value.

Note that in order to change the user's mailbox password, the server must be running the poppass service on port 106, on the same server. Because passwords are transmitted as clear text (unencrypted), this service is not considered secure and may not be available.

This method will return value of zero if the action was successful. Otherwise, a non-zero error code is returned which indicates the cause of the failure.

See Also

Password Property, UserName Property


Copyright © 2008 Catalyst Development Corporation. All rights reserved.