C++

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 C++ Downloads

Download Chilkat for C++

C++

#include <CkImap.h>
#include <CkEmail.h>

void ChilkatSample(void)
    {
    bool success = 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.

    CkImap imap;

    imap.put_Ssl(true);
    imap.put_Port(993);

    success = imap.Connect("imap.example.com");
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    success = imap.Login("user@example.com","myPassword");
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    //  Build the email to be uploaded.
    CkEmail email;
    email.put_Subject("Meeting agenda");
    email.put_From("Alice <alice@example.com>");
    success = email.AddTo("Bob","bob@example.com");
    email.put_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.
    const char *mimeText = email.getMime();
    if (email.get_LastMethodSuccess() == false) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    //  Append (upload) the MIME to the "Drafts" mailbox.
    success = imap.AppendMime("Drafts",mimeText);
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Appended UID: " << imap.get_AppendUid() << "\r\n";

    success = imap.Disconnect();
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }
    }