Sample code for 30+ languages & platforms
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 C Downloads

C
#include <C_CkMailMan.h>
#include <C_CkEmailBundle.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mail;
    HCkEmailBundle previews;
    HCkEmail header;
    int i;
    HCkEmail email;

    success = FALSE;

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

    mail = CkMailMan_Create();
    CkMailMan_putMailHost(mail,"pop.example.com");
    CkMailMan_putMailPort(mail,995);
    CkMailMan_putPopSsl(mail,TRUE);
    CkMailMan_putRequireSslCertVerify(mail,TRUE);
    CkMailMan_putPopUsername(mail,"MAIL_USER");
    CkMailMan_putPopPassword(mail,"MAIL_PASSWORD");
    previews = CkEmailBundle_Create();
    //  Keep the messages and request minimal previews. Range indexes are zero-based and inclusive.
    success = CkMailMan_FetchRange(mail,TRUE,TRUE,0,0,4,previews);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mail));
        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        return;
    }

    if (CkEmailBundle_getMessageCount(previews) == 0) {
        printf("There are no messages to preview.\n");
        success = CkMailMan_Pop3EndSession(mail);
        if (success != TRUE) {
            printf("%s\n",CkMailMan_lastErrorText(mail));
            CkMailMan_Dispose(mail);
            CkEmailBundle_Dispose(previews);
            return;
        }

        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        return;
    }

    header = CkEmail_Create();
    i = 0;
    while ((i < CkEmailBundle_getMessageCount(previews))) {
        success = CkEmailBundle_EmailAt(previews,i,header);
        if (success != TRUE) {
            printf("%s\n",CkEmailBundle_lastErrorText(previews));
            CkMailMan_Dispose(mail);
            CkEmailBundle_Dispose(previews);
            CkEmail_Dispose(header);
            return;
        }

        printf("%s  %s\n",CkEmail_uidl(header),CkEmail_subject(header));
        i = i + 1;
    }

    //  A UI could use its selected row here. FetchFull uses the preview's POP3 identity.
    success = CkEmailBundle_EmailAt(previews,0,header);
    if (success != TRUE) {
        printf("%s\n",CkEmailBundle_lastErrorText(previews));
        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        CkEmail_Dispose(header);
        return;
    }

    email = CkEmail_Create();
    success = CkMailMan_FetchFull(mail,header,email);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mail));
        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        CkEmail_Dispose(header);
        CkEmail_Dispose(email);
        return;
    }

    success = CkMailMan_Pop3EndSession(mail);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mail));
        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        CkEmail_Dispose(header);
        CkEmail_Dispose(email);
        return;
    }

    printf("Full message: %s  Files: %d\n",CkEmail_subject(email),CkEmail_getNumAttachments(email));

    success = CkEmail_SaveEml(email,"pop-received.eml");
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkMailMan_Dispose(mail);
        CkEmailBundle_Dispose(previews);
        CkEmail_Dispose(header);
        CkEmail_Dispose(email);
        return;
    }

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


    CkMailMan_Dispose(mail);
    CkEmailBundle_Dispose(previews);
    CkEmail_Dispose(header);
    CkEmail_Dispose(email);

    }