IMAP_CreateMB

4D - Documentation   Français   English   German   Japanese   4D Internet Commands, Theme List   4D Internet Commands, Alphabetical List   Back   Previous   Next

version 6.8.1


IMAP_CreateMB (imap_ID; mbName) Integer

ParameterTypeDescription
imap_IDLongintReference to an IMAP login
mbNameTextName of the mailbox to be created
Function resultIntegerError code

Description

The IMAP_CreateMB command creates a mailbox with the given name. If the IMAP server's hierarchy separator character appears elsewhere in the mailbox name, the IMAP server will create any parent names needed to create the given mailbox.

In other words, an attempt to create "Projects/IMAP/Doc" on a server in which "/" is the hierarchy separator character will create:

Only the "Doc" mailbox if "Projects" & "IMAP" already exist.

"IMAP" & "Doc" mailboxes if only "Projects" already exists.

"Projects" & "IMAP" & "Doc" mailboxes, if they do not already exist.

imap_ID is a long integer reference to an open connection created with IMAP_Login.

mbName is the full name of the mailbox to be created (see naming rules in the IMAP introduction).

Note: Attempting to create an INBOX (which is a special name reserved to mean "the primary mailbox for this user on this server") or a mailbox with a name referring to an existing mailbox will lead to an error.

See Also

IMAP_ListMBs, IMAP_RenameMB.


4D - Documentation   Français   English   German   Japanese   4D Internet Commands, Theme List   4D Internet Commands, Alphabetical List   Back   Previous   Next