PMDF popstore & MessageStore Manager's Guide


Previous Contents Index


POPSTORE_user_copy

Obsolete subroutine: use the more general POPSTORE_user_copy_d subroutine.

format


int POPSTORE_user_copy (old_user, old_user_len, new_user, 
                        new_user_len, new_password, 
                        new_password_len, do_rename) 
      char *old_user; 
      int   old_user_len; 
      char *new_user; 
      int   new_user_len; 
      char *new_password; 
      int   new_password_len; 
      int   do_rename; 


Arguments

old_user

Name of the popstore user to copy or rename. Used for input only.

old_user_len

Length in bytes of the string, old_user . Used for input only.

new_user

Name of the new popstore user to copy or rename the old_user account to. Used for input only.

new_user_len

Length in bytes of the string, new_user . Used for input only.

new_password

Optional argument specifying a new, plain text password to use for the new or renamed user profile. Used for input only.

new_password_len

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

do_rename

Boolean flag indicating whether to do a rename or a copy operation. Used for input only.

Description

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

Return Values

POPSTORE_SUCCESS Normal, successful completion.
POPSTORE_BADLENGTH The value of new_user_len is less than 1.
POPSTORE_FILOPNERR Unable to open the old profile file for reading or create the new profile file for writing.
POPSTORE_INSUFPRIV The calling process lacks SYSLCK privilege (OpenVMS only).
POPSTORE_LCKOPNERR Unable to obtain lock information for one of the profile files.
POPSTORE_LOCKERROR Unable to obtain a lock for one of the profile files.
POPSTORE_NOTINIT The API has not yet been initialized.
POPSTORE_READERROR An error while attempting to read data from the old profile file.
POPSTORE_SEEKERROR an error occurred while attempting to seek to a position in one of the profile files.
POPSTORE_TOOLONG The length of the new_user string exceeds POPSTORE_MAX_USER_LEN bytes or is otherwise too long; the length of the new_password string exceeds a length of POPSTORE_MAX_PWD_LEN bytes; or a resulting profile file name is too long.
POPSTORE_USEREXISTS An account with the name new_user already exists.
POPSTORE_VMERROR Insufficient virtual memory to perform requested operation.
POPSTORE_WRITERROR An error occurred while writing data to the new profile file.


Previous Next Contents Index