Fetch Single Email by UID or Sequence Number

Assuming the UID is known, download a single email by UID from an IMAP mail server.

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

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

    CkString strOut;

    CkImap imap;

    bool success;

    //  Anything unlocks the component and begins a fully-functional 30-day trial.
    success = imap.UnlockComponent("Anything for 30-day trial");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    //  Connect to an IMAP server.
    success = imap.Connect("mail.chilkatsoft.com");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    //  Login
    success = imap.Login("***","***");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    //  Select an IMAP mailbox
    success = imap.SelectMailbox("Inbox");
    if (success != true) {
        strOut.append(imap.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    CkEmail *email = 0;

    long uid;
    uid = 2014;
    bool isUid;
    isUid = true;

    email = imap.FetchSingle(uid,isUid);
    if (!(email == 0 )) {

        //  Display the From and Subject
        strOut.append(email->fromAddress());
        strOut.append("\r\n");
        strOut.append(email->subject());
        strOut.append("\r\n");

        //  Display the Body property, which is the default body.
        //  If an email has an HTML body, the Body property contains
        //  the HTML source.  Otherwise it contains the plain-text
        //  body.
        strOut.append("---- EMAIL BODY ----");
        strOut.append("\r\n");
        strOut.append(email->body());
        strOut.append("\r\n");
        strOut.append("--------------------");
        strOut.append("\r\n");

        //  Display the recipients:
        long j;
        for (j = 0; j <= email->get_NumTo() - 1; j++) {
            strOut.append(email->getToName(j));
            strOut.append(", ");
            strOut.append(email->getToAddr(j));
            strOut.append("\r\n");
        }

        for (j = 0; j <= email->get_NumCC() - 1; j++) {
            strOut.append(email->getCcName(j));
            strOut.append(", ");
            strOut.append(email->getCcAddr(j));
            strOut.append("\r\n");
        }

        //  Show the total size of the email, including body and attachments:
        strOut.appendInt(email->get_Size());
        strOut.append("\r\n");

        //  When a full email is downloaded, we would use the
        //  email.NumAttachments property in conjunction with the
        //  email.GetMailAttach* methods.
        //  However, when an email object contains only the header,
        //  we need to access the attachment info differently:
        long numAttach;
        numAttach = imap.GetMailNumAttach(*email);
        strOut.appendInt(numAttach);
        strOut.append("\r\n");

        for (j = 0; j <= numAttach - 1; j++) {
            strOut.append(imap.getMailAttachFilename(*email,j));
            strOut.append("\r\n");
            long attachSize;
            attachSize = imap.GetMailAttachSize(*email,j);
            strOut.append("    size = ");
            strOut.appendInt(attachSize);
            strOut.append(" bytes");
            strOut.append("\r\n");
        }

        strOut.append("--");
        strOut.append("\r\n");
        delete email;
    }

    //  Disconnect from the IMAP server.
    imap.Disconnect();

    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());