Create a multipart/related MIME Entity

See more MIME Examples

Demonstrates the Chilkat Mime.NewMultipartRelated method, which initializes the object as an empty multipart/related entity. It takes no arguments; the primary part and its related resources are then appended.

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: multipart/related ties a primary part to the resources it references — most commonly an HTML body and the inline images it embeds via cid: references. Unlike a plain attachment, a related image is displayed within the message rather than listed separately. The HTML part comes first, followed by each referenced resource with a matching Content-ID.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkMime.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMime mime;
    HCkMime htmlPart;

    success = FALSE;

    //  Demonstrates the Mime.NewMultipartRelated method, which initializes the object as an empty
    //  multipart/related entity, clearing any existing content.  It takes no arguments.

    mime = CkMime_Create();

    success = CkMime_NewMultipartRelated(mime);
    if (success == FALSE) {
        printf("%s\n",CkMime_lastErrorText(mime));
        CkMime_Dispose(mime);
        return;
    }

    //  multipart/related groups a primary part with the resources it references, such as an HTML body
    //  and the inline images it displays.
    htmlPart = CkMime_Create();
    success = CkMime_SetBodyFromHtml(htmlPart,"<html><body><img src=\"cid:logo\"></body></html>");
    if (success == FALSE) {
        printf("%s\n",CkMime_lastErrorText(htmlPart));
        CkMime_Dispose(mime);
        CkMime_Dispose(htmlPart);
        return;
    }

    success = CkMime_AppendPart(mime,htmlPart);
    if (success == FALSE) {
        printf("%s\n",CkMime_lastErrorText(mime));
        CkMime_Dispose(mime);
        CkMime_Dispose(htmlPart);
        return;
    }

    success = CkMime_AppendPartFromFile(mime,"qa_data/logo.png");
    if (success == FALSE) {
        printf("%s\n",CkMime_lastErrorText(mime));
        CkMime_Dispose(mime);
        CkMime_Dispose(htmlPart);
        return;
    }

    printf("Number of parts: %d\n",CkMime_getNumParts(mime));


    CkMime_Dispose(mime);
    CkMime_Dispose(htmlPart);

    }