Unicode C

Get a Summary of the MIME Structure

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 Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkMimeW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMimeW mime;
    const wchar_t *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 = CkMimeW_Create();

    success = CkMimeW_LoadMimeFile(mime,L"qa_data/multipart_message.eml");
    if (success == FALSE) {
        wprintf(L"%s\n",CkMimeW_lastErrorText(mime));
        CkMimeW_Dispose(mime);
        return;
    }

    //  Get a human-readable text outline of the MIME structure.
    structure = CkMimeW_getStructure(mime,L"text");
    if (CkMimeW_getLastMethodSuccess(mime) == FALSE) {
        wprintf(L"%s\n",CkMimeW_lastErrorText(mime));
        CkMimeW_Dispose(mime);
        return;
    }

    wprintf(L"%s\n",structure);


    CkMimeW_Dispose(mime);

    }