Fetch an IMAP Message's MIME into a BinData

See more IMAP Examples

Demonstrates the Chilkat Imap.FetchSingleBd method, which downloads one message's MIME bytes into a BinData object. If the second argument (bUid) is true, the first argument is a UID; otherwise it is a sequence number. This example downloads message 1's MIME into a BinData and prints the byte count.

Background: This is the binary counterpart to FetchSingleAsMime (which returns a string). A BinData holds raw bytes, so it preserves the message exactly — the right choice when you plan to write the MIME straight to a file, hash it, or hand it to an API expecting a byte buffer, with no charset conversion that could alter binary content.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkImap.h>
#include <C_CkBinData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkImap imap;
    HCkBinData bdMime;

    success = FALSE;

    //  Demonstrates the Imap.FetchSingleBd method, which downloads one message's MIME bytes into a
    //  BinData object.  If the 2nd argument (bUid) is TRUE, the 1st argument is a UID; otherwise
    //  it is a sequence number.

    imap = CkImap_Create();

    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;
    }

    success = CkImap_Login(imap,"user@example.com","myPassword");
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        return;
    }

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

    //  Download message sequence number 1's MIME bytes into a BinData.  bUid = FALSE.
    bdMime = CkBinData_Create();
    success = CkImap_FetchSingleBd(imap,1,FALSE,bdMime);
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkBinData_Dispose(bdMime);
        return;
    }

    printf("MIME size (bytes) = %d\n",CkBinData_getNumBytes(bdMime));

    success = CkImap_Disconnect(imap);
    if (success == FALSE) {
        printf("%s\n",CkImap_lastErrorText(imap));
        CkImap_Dispose(imap);
        CkBinData_Dispose(bdMime);
        return;
    }



    CkImap_Dispose(imap);
    CkBinData_Dispose(bdMime);

    }