Create a new popstore account.

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.