4D Internet Commands v16

IMAP_RenameMB

Home

 
4D Internet Commands v16
IMAP_RenameMB

IMAP_RenameMB 


 

IMAP_RenameMB ( imap_ID ; mbName ; newMBName ) -> Function result 
Parameter Type   Description
imap_ID  Longint in Reference to an IMAP login
mbName  Text in Name of the mailbox to be renamed
newMBName  Text in New mailbox name
Function result  Integer in Error code

The IMAP_RenameMB command changes the name of a mailbox. Attempting to rename a mailbox from a mailbox name that does not exist or to a mailbox name that already exists will generate an error.

Note: Renaming an INBOX is permitted and involves special behavior. It moves all messages in the INBOX to a new mailbox with the given name, leaving the INBOX empty. If the server implementation allows child names for the INBOX, these are unaffected by its renaming.

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 renamed (see naming rules in the IMAP introduction).

newMBName is the full name to apply to rename the mbName mailbox.



See also 

IMAP_CreateMB
IMAP_ListMBs
IMAP_Login

 
PROPERTIES 

Product: 4D Internet Commands
Theme: IC IMAP Review Mail
Number: 88860

 
HISTORY 

Created: 4D Internet Commands 6.8.1

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)