PMDF popstore & MessageStore Manager's Guide


Previous Contents Index


POPSTORE_user_create

Create a new popstore account.

format


int POPSTORE_user_create (user_context) 
      POPSTORE_user_context **user_context; 


Arguments

user_context

Address of a pointer to a POPSTORE_user_context structure created by a prior call to POPSTORE_user_create_set . Used for input and output.

Description

Once a POPSTORE_user_context structure has been initialized with calls to POPSTORE_user_create_set , a user account is then created with POPSTORE_user_create . POPSTORE_user_create will create a new profile file and user database entry containing the information contained in the POPSTORE_user_context structure. Once the account is created, it can then begin receiving mail and be accessed by POP clients. When the account is created, the last billing field for the account is set to the creation time for the profile file. An example of using POPSTORE_user_create and POPSTORE_user_create_set is given in Example 12-1.

Return Values

POPSTORE_SUCCESS Normal, successful completion.
POPSTORE_DBBADLENGTH New user record would not fit in the user database. New account not created. In practice, this error should never occur.
POPSTORE_DBERR An unknown error occurred while attempting to add the new user record to the user database. New account not created. In practice, this error should never occur.
POPSTORE_DBOPNERR Unable to open the user database. New account not created.
POPSTORE_DBPUTERR Unable to add the new user record to the user database. New account not created.
POPSTORE_DIRCRTERR Unable to create a directory in the required directory path. New account not created.
POPSTORE_FILCLSERR An error occurred while closing the new profile file. New account was created.
POPSTORE_FILOPNERR Unable to create the new profile file for writing. New account not created.
POPSTORE_ILLUSRNAM Username field has zero length. New account not created.
POPSTORE_INSUFPRIV The process lacks SYSLCK privilege (OpenVMS only). New account not created.
POPSTORE_LCKOPNERR Unable to obtain lock information for the profile file. New account not created.
POPSTORE_LOCKERROR Unable to obtain a lock for the profile file. New account not created.
POPSTORE_NOPRIVILEGE MANAGE flag was set but xxx.
POPSTORE_NOSUCHUSER Username contains illegal characters or is too long. New account not created.
POPSTORE_NULLCONTEXT user_context argument was NULL. New account not created.
POPSTORE_TOOLONG Resulting file name for the profile file is too long. This error usually should not occur. New account not created.
POPSTORE_USEREXISTS Username conflicts with an already existing account. New account not created.
POPSTORE_WRITERROR An error occured while attempting to write the new profile file. New profile file deleted; new account not created.


Previous Next Contents Index