C++

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

Download Chilkat for C++

C++

#include <CkImap.h>

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

    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;
    }

    //  Select the source mailbox.
    success = imap.SelectMailbox("Inbox");
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    //  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) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Message copied." << "\r\n";

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