PMDF popstore & MessageStore Manager's Guide
PMDF-POP-6.0

Previous | Contents

POPSTORE_user_delete_d

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.

Previous | Next | Contents