C

Fetch Single Email by UID or Sequence Number

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

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

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

    success = FALSE;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    imap = CkImap_Create();

    // Connect to an IMAP server.
    // Use TLS
    CkImap_putSsl(imap,TRUE);
    CkImap_putPort(imap,993);
    success = CkImap_Connect(imap,"imap.example.com");
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

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

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

    email = CkEmail_Create();

    uid = 2014;
    isUid = TRUE;

    success = CkImap_FetchEmail(imap,FALSE,uid,isUid,email);
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkEmail_Dispose(email);
        return;
    }

    // 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");

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


    CkImap_Dispose(imap);
    CkEmail_Dispose(email);

    }