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

Previous | Contents

POPSTORE_message_mark_nodelete

Mark a user's message to be retained.
FORMAT 
int POPSTORE_message_mark_nodelete (user_context, 
                                    message_index) 
      POPSTORE_user_context *user_context; 
      int                    message_index;

ARGUMENTS

user_context

User context created by a prior call to POPSTORE_user_begin_d. Used for input only.

message_index

Index of the message to mark to keep and not delete. Used for input only.

DESCRIPTION

To mark a user's stored message to be retained and not deleted, call POPSTORE_message_mark_nodelete. The index of the message to retain is specified with message_index. The first message has index 1, the second index 2, and so on.
Return Values
POPSTORE_SUCCESS Normal, successful completion.
POPSTORE_BADMSGID Message index is less than 1 or greater than user_context->message_count.
POPSTORE_NULLCONTEXT user_context context is null.
POPSTORE_NULLMSGLIST user_context->messages is null.
POPSTORE_NULLPROFILE user_context->profile context is null.

Previous | Next | Contents