4D Internet Commands v14

IMAP_DeleteMB

Home

 
4D Internet Commands v14
IMAP_DeleteMB

IMAP_DeleteMB 


 

IMAP_DeleteMB ( imap_ID ; mbName ) -> Function result 
Parameter Type   Description
imap_ID  Longint in Reference to an IMAP login
mbName  Text in Mailbox name to be deleted
Function result  Integer in Error code

The IMAP_DeleteMB command permanently removes the mailbox of a given name. Attempting to delete an INBOX or a mailbox that does not exist will generate an error.

The IMAP_DeleteMB command cannot delete a mailbox which has child mailboxes and which also has the \Noselect mailbox attribute.

It is possible to delete a mailbox that has child names and does not have the \Noselect mailbox attribute. In this case, all messages in the mailbox are removed and it acquires the \Noselect mailbox attribute.

Note: The IMAP protocol does not guarantee that you can delete a mailbox which is not empty, though on some servers this is allowed. If you do choose to attempt it, you must be prepared to use another method should the more convenient one fail. Further, you should not try to delete the current working mailbox while it is open, but should first close it; some servers do not permit deletion of the current mailbox.

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 deleted.

 
PROPERTIES 

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

 
HISTORY 

Created: 4D Internet Commands 6.8.1

 
SEE ALSO 

IMAP_CloseCurrentMB
IMAP_Delete
IMAP_SetCurrentMB

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)