PMDF popstore & MessageStore Manager's Guide
Previous Next Contents Index

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 
                               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.

Previous Next Contents Index