PMDF popstore & MessageStore Manager's Guide
PMDF-POP-6.0

Previous | Contents

POPSTORE_user_pw_change_d

Change a user's password.
FORMAT 
int POPSTORE_user_pw_change_d (domain, domain_len, user, 
                               user_len, new_password, 
                               new_password_len) 
      char *domain; 
      int   domain_len; 
      char *user; 
      int   user_len; 
      char *new_password; 
      int   new_password_len;

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.

DESCRIPTION

A user's password may be changed with POPSTORE_user_pw_change. As input, supply the name of the user to effect the change for as well as the new, plain text password to use. The length of the new password may 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.

Previous | Next | Contents