Share this page

# imap_create_ex

Internet Messaging Functions (IMAP)

Creates a mailbox for a specific IMAP session.

    int imap_create_ex( IMAP *ppimap, char *transaction, char *mailbox, LAST );

ppimap | A session identifier.
transaction | A transaction name for this step in quotes. To avoid creating a transaction for this step, use a null string, "".
mailbox | The name of the mailbox(es) to create.`"MAILBOX=`mailbox1`", "MAILBOX=`mailbox2`", ...`
LAST | A marker indicating the end of the argument list.

The imap_create_ex function creates a new mailbox for a specific session.

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

## Return Values

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

## Parameterization

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

## Example

In the following example, the imap_create_ex function creates multiple mailboxes.

        imap_create_ex(&imap1,"CreateMailbox",
               "Mailbox=MyMailbox",
                LAST );

        imap_create_ex(&imap1,"CreateMailboxes",
                "Mailbox=Products",
                "Mailbox=Solutions",
                "Mailbox=FAQs",
                LAST );

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