C++

Create an IMAP Mailbox

Demonstrates the Chilkat Imap.CreateMailbox method, which creates a mailbox on the IMAP server. When creating nested mailboxes, use the server's hierarchy delimiter reported in the SeparatorChar property. This example creates a mailbox named Archive2026.

Background: IMAP folders form a hierarchy, and the character that separates levels varies by server — commonly / or .. To create a sub-folder you build the path with that delimiter (for example Archive/2026), which is why you should read SeparatorChar rather than assume one. Creating mailboxes lets an application organize mail into folders programmatically, such as filing messages by year or project.

Chilkat C++ Downloads

Download Chilkat for C++

C++

#include <CkImap.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Demonstrates the Imap.CreateMailbox method, which creates a mailbox on the IMAP server.
    //  Use the server's hierarchy delimiter (the SeparatorChar property) when creating nested
    //  mailboxes.

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

    //  Create a new mailbox (folder) on the server.
    success = imap.CreateMailbox("Archive2026");
    if (success == false) {
        std::cout << imap.lastErrorText() << "\r\n";
        return;
    }

    std::cout << "Mailbox created." << "\r\n";

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