Delete a user account.

format

int POPSTORE_user_delete_d (domain, domain_len, user, user_len, do_return) char *domain; int domain_len; char *user; int user_len; int do_return;

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

Username for the popstore account to delete. Used for input only.

user_len

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

do_return

Boolean flag indicating whether or not unread mail should be silently deleted or returned as unread. Used for input only.

Description

The POPSTORE_user_delete_d subroutine is used to delete a user's account and, optionally, to return any unread messages stored for that user. The user argument specifies the name of the account to delete. When do_return has a non-zero value, any unread messages stored for the user are returned as unread to their originators.

Return Values

POPSTORE_SUCCESS	Normal, successful completion.
POPSTORE_FILDELERR	Unable to delete the underlying profile file.
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.