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

#include <C_CkImap.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkImap imap;
    BOOL success;
    HCkEmail email;
    long uid;
    BOOL isUid;
    long j;
    long numAttach;
    long attachSize;

    imap = CkImap_Create();

    //  Anything unlocks the component and begins a fully-functional 30-day trial.
    success = CkImap_UnlockComponent(imap,"Anything for 30-day trial");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        return;
    }

    //  Connect to an IMAP server.
    success = CkImap_Connect(imap,"mail.chilkatsoft.com");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        return;
    }

    //  Login
    success = CkImap_Login(imap,"***","***");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        return;
    }

    //  Select an IMAP mailbox
    success = CkImap_SelectMailbox(imap,"Inbox");
    if (success != TRUE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        return;
    }

    uid = 2014;

    isUid = TRUE;

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

        //  Display the From and Subject
        printf("%s\n",CkEmail_fromAddress(email));
        printf("%s\n",CkEmail_subject(email));

        //  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.
        printf("---- EMAIL BODY ----\n");
        printf("%s\n",CkEmail_body(email));
        printf("--------------------\n");

        //  Display the recipients:

        for (j = 0; j <= CkEmail_getNumTo(email) - 1; j++) {
            printf("%s, %s\n",CkEmail_getToName(email,j)
                ,CkEmail_getToAddr(email,j));
        }

        for (j = 0; j <= CkEmail_getNumCC(email) - 1; j++) {
            printf("%s, %s\n",CkEmail_getCcName(email,j)
                ,CkEmail_getCcAddr(email,j));
        }

        //  Show the total size of the email, including body and attachments:
        printf("%d\n",CkEmail_getSize(email));

        //  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:

        numAttach = CkImap_GetMailNumAttach(imap,email);
        printf("%d\n",numAttach);

        for (j = 0; j <= numAttach - 1; j++) {
            printf("%s\n",CkImap_getMailAttachFilename(imap,email,j));

            attachSize = CkImap_GetMailAttachSize(imap,email,j);
            printf("    size = %d bytes\n",attachSize);
        }

        printf("--\n");
        CkEmail_Dispose(email);
    }

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

    CkImap_Dispose(imap);

    }