B4X

Append a MIME Message to an IMAP Mailbox

Demonstrates the Chilkat Imap.AppendMime method, which uploads a complete RFC 822/MIME message to a mailbox. The first argument is the destination mailbox name and the second is the MIME text. This example obtains the MIME from an Email object and uploads it to Drafts.

Background: Use AppendMime when you already hold a message's raw source — a .eml file, a message you assembled, or one you received. Chilkat sends the text exactly as supplied, without normalizing line endings or re-encoding headers, so every header and MIME boundary is preserved verbatim. The supplied text must be plain text (no raw non-text binary bytes).

Chilkat B4X Downloads

Download Chilkat for B4X

B4X

Dim success As Boolean = False

'  Demonstrates the Imap.AppendMime method, which uploads a complete MIME message to a mailbox.
'  The 1st argument is the destination mailbox name and the 2nd is the MIME text.

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


'  Build the email to be uploaded.
Dim email As ChilkatEmail
email.Initialize
email.Subject = "Meeting agenda"
email.From = "Alice <alice@example.com>"
success = email.AddTo("Bob", "bob@example.com")
email.Body = "Let's meet at 10am to review the agenda."

'  Obtain the MIME text to upload.  Here it is generated from the Email, but it could equally
'  be read from a .eml file.
Dim mimeText As String = email.GetMime
If email.LastMethodSuccess = False Then
    Log(email.LastErrorText)
    Return
End If


'  Append (upload) the MIME to the "Drafts" mailbox.
success = imap.AppendMime("Drafts", mimeText)
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


Log("Appended UID: " & imap.AppendUid)

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