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

Find an email by subject and fetch it by IMAP UID

See more Email Object Examples

Search the selected INBOX by subject and fetch the first matching UID into an Email. The example requests complete attachment bodies and uses peek mode to preserve the read flag. Configure your own IMAP TLS endpoint and credentials.

Chilkat Unicode C Downloads

Unicode C
#include <C_CkImapW.h>
#include <C_CkMessageSetW.h>
#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkImapW imap;
    HCkMessageSetW matches;
    unsigned long uid;
    HCkEmailW email;

    success = FALSE;

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

    imap = CkImapW_Create();
    CkImapW_putSsl(imap,TRUE);
    CkImapW_putPort(imap,993);
    CkImapW_putRequireSslCertVerify(imap,TRUE);
    CkImapW_putPeekMode(imap,TRUE);
    CkImapW_putAutoDownloadAttachments(imap,TRUE);
    success = CkImapW_Connect(imap,L"imap.example.com");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    success = CkImapW_Login(imap,L"MAIL_USER",L"MAIL_PASSWORD");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    success = CkImapW_SelectMailbox(imap,L"INBOX");
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        return;
    }

    matches = CkMessageSetW_Create();
    success = CkImapW_QueryMbx(imap,L"SUBJECT \"Sample message\"",TRUE,matches);
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkMessageSetW_Dispose(matches);
        return;
    }

    if (CkMessageSetW_getCount(matches) == 0) {
        wprintf(L"No matching message in INBOX.\n");
        success = CkImapW_Disconnect(imap);
        if (success != TRUE) {
            wprintf(L"%s\n",CkImapW_lastErrorText(imap));
            CkImapW_Dispose(imap);
            CkMessageSetW_Dispose(matches);
            return;
        }

        CkImapW_Dispose(imap);
        CkMessageSetW_Dispose(matches);
        return;
    }

    //  The search returned UIDs. Use the same identifier type for the fetch.
    uid = CkMessageSetW_GetId(matches,0);
    email = CkEmailW_Create();
    success = CkImapW_FetchEmail(imap,FALSE,uid,TRUE,email);
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkMessageSetW_Dispose(matches);
        CkEmailW_Dispose(email);
        return;
    }

    wprintf(L"Mailbox INBOX, UIDVALIDITY %u, UID %u\n",CkImapW_getUidValidity(imap),uid);
    success = CkImapW_Disconnect(imap);
    if (success != TRUE) {
        wprintf(L"%s\n",CkImapW_lastErrorText(imap));
        CkImapW_Dispose(imap);
        CkMessageSetW_Dispose(matches);
        CkEmailW_Dispose(email);
        return;
    }

    //  The downloaded Email remains usable after disconnecting.
    wprintf(L"Subject: %s  Files: %d\n",CkEmailW_subject(email),CkEmailW_getNumAttachments(email));

    success = CkEmailW_SaveEml(email,L"imap-received.eml");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkImapW_Dispose(imap);
        CkMessageSetW_Dispose(matches);
        CkEmailW_Dispose(email);
        return;
    }

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


    CkImapW_Dispose(imap);
    CkMessageSetW_Dispose(matches);
    CkEmailW_Dispose(email);

    }