Share this page

# mapi_read_next_mail_ex

Example: mapi_read_next_mail_ex | MS Exchange Server Functions (MAPI)

Reads the next mail in the mailbox for a specific session.

    int mapi_read_next_mail_ex( MAPI *ppmapi, char *transaction, char *Show, [char *Peek,][char *Type,][char *Save,][char *MessageId,] LAST );

ppmapi | A session identifier.
transaction | A transaction name for this step in quotes. To instruct VuGen not to create a transaction for this step, use a NULL string, "".
Show | The show option of the mail message in the format: `"Show=id | heading | summary | all (default`)`"`
Peek | The peek setting. If set to true, the function just peeks at the message without reading it. The message will not be marked as read. `"Peek=true | false (default)"`
Type | The type of mail message. For example, IPM.Note indicates a sticky note. The default is a simple mail message. Use the following format: `"Type=mail_type"`
Save | Save the body of the current message to the "Content" property: "`Save=body`"
MessageId | Sets which mail to read next: "`MessageId =<Message Id>`"
LAST | A marker indicating the end of the argument list.

The mapi_read_next_mail_ex function reads the next mail message in the mailbox, for the specified session. Using the Peek option, you can control whether or not to mark the mail as read or unread.

This function is for use with multiple sessions. For global sessions, use the mapi_read_next_mail function, which leaves out the session identifier.

## Return Values

If this function succeeds, it returns LR_PASS. Otherwise, it returns LR_FAIL.

When there are no more messages in the mailbox, returns LR_MAPI_NO_MORE_MESSAGES (0x80000001).

## Parameterization

All arguments of this function of the type char, can be parameterized with standard parameterization.

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: