Get a Summary of the MIME Structure

See more MIME Examples

Demonstrates the Chilkat Mime.GetStructure method, which returns a concise summary of the MIME tree. The only argument selects the format: xml for XML, or text (the default for any other value) for a plain-text outline.

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: A real message can nest multipart containers several levels deep — a multipart/mixed holding a multipart/alternative of text and HTML plus attachments — and GetStructure renders that hierarchy at a glance without the full content. It is the fast way to understand or debug an unfamiliar message's layout, in either a readable text outline or machine-parseable XML.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkMime.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMime mime;
    const char *structure;

    success = FALSE;

    //  Demonstrates the Mime.GetStructure method, which returns a concise summary of the MIME tree.
    //  The only argument selects the output format: "xml" for XML, or "text" (the default) for a
    //  plain-text outline.

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

    //  Get a human-readable text outline of the MIME structure.
    structure = CkMime_getStructure(mime,"text");
    if (CkMime_getLastMethodSuccess(mime) == FALSE) {
        printf("%s\n",CkMime_lastErrorText(mime));
        CkMime_Dispose(mime);
        return;
    }

    printf("%s\n",structure);


    CkMime_Dispose(mime);

    }