PMDF popstore & MessageStore Manager's Guide


Previous Contents Index


POPSTORE_user_pw_change

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.


Previous Next Contents Index