Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

Preview POP3 messages and download a complete email

See more Email Object Examples

Read a short preview for each of up to five messages into an EmailBundle, print their subjects, and download the complete first entry into a separate Email. Configure a POP3 account that supports UIDL and TOP. All messages stay on the server.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkMailManW.h>
#include <C_CkEmailBundleW.h>
#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailManW mail;
    HCkEmailBundleW previews;
    HCkEmailW header;
    int i;
    HCkEmailW email;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.

    mail = CkMailManW_Create();
    CkMailManW_putMailHost(mail,L"pop.example.com");
    CkMailManW_putMailPort(mail,995);
    CkMailManW_putPopSsl(mail,TRUE);
    CkMailManW_putRequireSslCertVerify(mail,TRUE);
    CkMailManW_putPopUsername(mail,L"MAIL_USER");
    CkMailManW_putPopPassword(mail,L"MAIL_PASSWORD");
    previews = CkEmailBundleW_Create();
    //  Keep the messages and request minimal previews. Range indexes are zero-based and inclusive.
    success = CkMailManW_FetchRange(mail,TRUE,TRUE,0,0,4,previews);
    if (success != TRUE) {
        wprintf(L"%s\n",CkMailManW_lastErrorText(mail));
        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        return;
    }

    if (CkEmailBundleW_getMessageCount(previews) == 0) {
        wprintf(L"There are no messages to preview.\n");
        success = CkMailManW_Pop3EndSession(mail);
        if (success != TRUE) {
            wprintf(L"%s\n",CkMailManW_lastErrorText(mail));
            CkMailManW_Dispose(mail);
            CkEmailBundleW_Dispose(previews);
            return;
        }

        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        return;
    }

    header = CkEmailW_Create();
    i = 0;
    while ((i < CkEmailBundleW_getMessageCount(previews))) {
        success = CkEmailBundleW_EmailAt(previews,i,header);
        if (success != TRUE) {
            wprintf(L"%s\n",CkEmailBundleW_lastErrorText(previews));
            CkMailManW_Dispose(mail);
            CkEmailBundleW_Dispose(previews);
            CkEmailW_Dispose(header);
            return;
        }

        wprintf(L"%s  %s\n",CkEmailW_uidl(header),CkEmailW_subject(header));
        i = i + 1;
    }

    //  A UI could use its selected row here. FetchFull uses the preview's POP3 identity.
    success = CkEmailBundleW_EmailAt(previews,0,header);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailBundleW_lastErrorText(previews));
        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        CkEmailW_Dispose(header);
        return;
    }

    email = CkEmailW_Create();
    success = CkMailManW_FetchFull(mail,header,email);
    if (success != TRUE) {
        wprintf(L"%s\n",CkMailManW_lastErrorText(mail));
        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        CkEmailW_Dispose(header);
        CkEmailW_Dispose(email);
        return;
    }

    success = CkMailManW_Pop3EndSession(mail);
    if (success != TRUE) {
        wprintf(L"%s\n",CkMailManW_lastErrorText(mail));
        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        CkEmailW_Dispose(header);
        CkEmailW_Dispose(email);
        return;
    }

    wprintf(L"Full message: %s  Files: %d\n",CkEmailW_subject(email),CkEmailW_getNumAttachments(email));

    success = CkEmailW_SaveEml(email,L"pop-received.eml");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkMailManW_Dispose(mail);
        CkEmailBundleW_Dispose(previews);
        CkEmailW_Dispose(header);
        CkEmailW_Dispose(email);
        return;
    }

    wprintf(L"Saved pop-received.eml.\n");


    CkMailManW_Dispose(mail);
    CkEmailBundleW_Dispose(previews);
    CkEmailW_Dispose(header);
    CkEmailW_Dispose(email);

    }