Obsolete subroutine: use the more general POPSTORE_user_pw_change_d subroutine.

format

int POPSTORE_user_pw_change (user, user_len, new_password, new_password_len, errmsg, errmsg_len, errmsg_max) char *user; int user_len; char *new_password; int new_password_len; char *errmsg; int *errmsg_len; int errmsg_max;

Arguments

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

While still supported, this subroutine is now obsolete. Use the more general POPSTORE_user_pw_change_d subroutine.

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.