B4X

Copy an IMAP Message to Another Mailbox

Demonstrates the Chilkat Imap.Copy method, which copies one message from the currently selected mailbox to a destination mailbox. The first argument identifies the source message; the second (bUid) indicates whether the id is a UID (true) or a sequence number (false). This example copies a message from the Inbox to another mailbox.

Background: Messages can be identified two ways in IMAP: a sequence number (the message's current 1-based position, which shifts as messages are added or expunged) or a UID (a stable identifier that doesn't change). The bUid flag tells Copy which you're passing. Copying leaves the original in place and places a duplicate in the destination — use MoveMessages to relocate instead of duplicate.

Chilkat B4X Downloads

Download Chilkat for B4X

B4X

Dim success As Boolean = False

'  Demonstrates the Imap.Copy method, which copies one message from the currently selected
'  mailbox to a destination mailbox.  The 1st argument identifies the source message; the 2nd
'  (bUid) indicates whether the id is a UID (True) or a sequence number (False).

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 source mailbox.
success = imap.SelectMailbox("Inbox")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Copy message sequence number 1 to the "Archive2026" mailbox.  bUid = False means the id
'  is a sequence number, not a UID.
success = imap.Copy(1, False, "Archive2026")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


Log("Message copied.")

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