Change a user's password.

format

int POPSTORE_user_pw_change_d (domain, domain_len, user, user_len, new_password, new_password_len errmsg, errmsg_len, errmsg_max) char *domain; int domain_len; char *user; int user_len; char *new_password; int new_password_len; char *errmsg; int *errmsg_len; int errmsg_max;

Arguments

domain

Name of the user domain to use. Supply a value of NULL to indicate the default domain. Used for input only.

domain_len

Length in bytes of the user domain name, domain . Supply a value of zero to indicate the default domain. Used for input only.

user

Name of the user to change the password for. Used for input only.

user_len

Length of the username string, user . Used for input only.

new_password

New password to use for the account. Used for input only.

new_password_len

Length in bytes of the new password string, new_password . Used for input only.

errmsg

Address of character array that POPSTORE_user_pw_change can put an error message into if the password change fails.

errmsg_len

Address of an integer that POPSTORE_user_pw_change can write the length of the error message that it put into errmsg .

errmsg_max

The size of the array that errmsg points to.

Description

A user's password can be changed with POPSTORE_user_pw_change_d. As input, supply the name of the user to effect the change for as well as the new, plain text password to use, and the user domain. The length of the new password can not exceed POPSTORE_MAX_PWD_LEN bytes. Note that if you already have a user context from POPSTORE_user_begin_d, then you can call POPSTORE_user_update to change the password.

Return Values

POPSTORE_SUCCESS	Normal, successful completion.
POPSTORE_FILOPNERR	Unable to open the profile file for reading.
POPSTORE_INSUFPRIV	Insufficient privileges to access the profile file, or, on OpenVMS, the process lacks SYSLCK privilege.
POPSTORE_LCKOPNERR	Unable to obtain lock information for the profile file.
POPSTORE_LOCKERROR	Unable to obtain a lock for the profile file.
POPSTORE_NOSUCHUSR	No such user account.
POPSTORE_READERROR	An error while attempting to read data from the profile file.
POPSTORE_TOOLONG	The resulting profile file name is too long.
POPSTORE_VMERROR	Insufficient virtual memory.
POPSTORE_WRITERROR	An error occurred while writing data to the user's profile file.