B4X

Expunge Deleted Messages from a Mailbox

Demonstrates the Chilkat Imap.Expunge method, which permanently removes all messages marked with the \Deleted flag from the currently selected mailbox. The mailbox remains selected. This example marks a message deleted with SetFlag and then expunges.

Background: IMAP deletion is two-phase, much like POP3. First a message is marked with the \Deleted flag (it still exists, just tagged); then EXPUNGE permanently removes every flagged message and renumbers the rest. Splitting the two steps lets a client mark several messages and remove them together, or unmark (undelete) before committing. Expunge keeps the mailbox selected; ExpungeAndClose does the same and then closes it.

Chilkat B4X Downloads

Download Chilkat for B4X

B4X

Dim success As Boolean = False

'  Demonstrates the Imap.Expunge method, which permanently removes all messages marked with
'  the \Deleted flag from the currently selected mailbox.  The mailbox remains selected.

Dim imap As ChilkatImap
imap.Initialize("imap")

imap.Ssl = True
imap.Port = 993

success = imap.Connect("imap.example.com")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If

success = imap.Login("user@example.com", "myPassword")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Select the mailbox to operate on.
success = imap.SelectMailbox("Inbox")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Mark message (sequence number 1) with the \Deleted flag.  The 4th argument (1) sets the
'  flag; the 2nd argument (False) means the id is a sequence number, not a UID.
success = imap.SetFlag(1, False, "\Deleted", 1)
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Permanently remove all \Deleted messages from the selected mailbox.
success = imap.Expunge
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


Log("Expunged the deleted messages.")

success = imap.Disconnect
If success = False Then
    Log(imap.LastErrorText)
    Return
End If