IMAP_Delete
version 6.8.1
IMAP_Delete (imap_ID; startMsg; endMsg) 
Integer
| Parameter | Type | Description | |
| imap_ID | Longint | | Reference to an IMAP login |
| startMsg | Longint | | Start message number |
| endMsg | Longint | | End message number |
Function result Integer 
Error code
Description
The IMAP_Delete command sets the \Deleted flag for the startMsg to endMsg range of messages and then deletes all messages where the \Deleted flag is set (including messages where the \Deleted flag has previously been set for the current session). Deletion is executed by the IMAP server and takes place when closing the connection (IMAP_Logout) or selecting another current mailbox (IMAP_SetCurrentMB) or closing the current mailbox (IMAP_CloseCurrentMB).
If you do not want to delete right away, you can use the IMAP_SetFlags command and set the \Deleted flag to delete messages later.
imap_ID is a long integer reference to an open connection created with IMAP_Login.
startMsg is a long integer number which is the starting message number of the messages to delete.
endMsg is a long integer number which is the ending message number of the messages to delete.
Note: The IMAP_Delete, IMAP_MsgLstInfo, IMAP_MsgLst, IMAP_SetFlags, IMAP_GetFlags and IMAP_CopyToMB commands do not return an error if the startMsg is greater than the endMsg. In the event that this occurs, the command – in effect – does nothing.
See Also
IMAP_CloseCurrentMB, IMAP_Logout, IMAP_SetCurrentMB, IMAP_SetFlags.