Access a Part in a Multipart MIME Entity

See more MIME Examples

Demonstrates the Chilkat Mime.PartAt method, which provides live access to the direct child at a zero-based index. The first argument is the index and the second is a Mime object that will reference the child. Modifying it modifies the child stored in the parent tree.

Note: The file paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: This is how you reach into a multipart message to inspect or edit an individual part — read a part's Content-Type, extract an attachment's body, or change a part in place. The key point is that the returned Mime is a live reference, not a copy, so edits to it flow back into the parent tree. Loop from 0 to NumParts - 1 to visit every direct child.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkMime.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMime mime;
    int n;
    HCkMime part;
    int i;

    success = FALSE;

    mime = CkMime_Create();
    success = CkMime_LoadMimeFile(mime,"qa_data/multipart_message.eml");
    if (success == FALSE) {
        printf("%s\n",CkMime_lastErrorText(mime));
        CkMime_Dispose(mime);
        return;
    }

    //  PartAt provides LIVE access to a direct child part.  The 1st argument is the zero-based index
    //  and the 2nd is a Mime object that will reference the child.  Modifying it modifies the child in
    //  the parent tree.
    n = CkMime_getNumParts(mime);
    printf("Number of parts: %d\n",n);

    part = CkMime_Create();

    for (i = 0; i <= n - 1; i++) {
        success = CkMime_PartAt(mime,i,part);
        if (success == FALSE) {
            printf("%s\n",CkMime_lastErrorText(mime));
            CkMime_Dispose(mime);
            CkMime_Dispose(part);
            return;
        }

        printf("Part %d Content-Type: %s\n",i,CkMime_contentType(part));
    }



    CkMime_Dispose(mime);
    CkMime_Dispose(part);

    }