(C) Build a multipart/related MIME Message

Demonstrates how to construct a multipart/related MIME message containing HTML and a related JPG image.

Chilkat C/C++ Library Downloads

MS Visual C/C++

Linux/CentOS C/C++

Alpine Linux C/C++

MAC OS X C/C++

armhf/aarch64 C/C++

C++ Builder

iOS C/C++

Android C/C++

Solaris C/C++

MinGW C/C++

#include <C_CkMime.h>
#include <C_CkCrypt2.h>
#include <C_CkStringBuilder.h>
#include <C_CkFileAccess.h>
#include <C_CkByteData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMime mime;
    HCkCrypt2 crypt;
    HCkStringBuilder sbContentId;
    HCkStringBuilder sbHtml;
    int numReplacements;
    HCkMime htmlMime;
    HCkFileAccess fac;
    HCkByteData jpgBytes;
    HCkMime jpgMime;
    HCkStringBuilder sbContentIdHdr;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // Start with an empty MIME object...
    mime = CkMime_Create();

    // Initialize it as multipart/related.
    CkMime_NewMultipartRelated(mime);

    // Set a top-level MIME header field.
    CkMime_SetHeaderField(mime,"Subject","Test HTML email with JPG image.");

    // Generate a Content-ID.  This will contain random data that will allow
    // the HTML's "img" tag to reference the image part in the MIME.
    crypt = CkCrypt2_Create();
    CkCrypt2_putEncodingMode(crypt,"hex");

    sbContentId = CkStringBuilder_Create();
    CkStringBuilder_Append(sbContentId,"part1.");
    CkStringBuilder_Append(sbContentId,CkCrypt2_genRandomBytesENC(crypt,4));
    CkStringBuilder_Append(sbContentId,".");
    CkStringBuilder_Append(sbContentId,CkCrypt2_genRandomBytesENC(crypt,4));
    CkStringBuilder_Append(sbContentId,"@chilkatsoft.com");

    // Create the HTML body.
    sbHtml = CkStringBuilder_Create();
    CkStringBuilder_Append(sbHtml,"<html><head>\r\n");
    CkStringBuilder_Append(sbHtml,"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n");
    CkStringBuilder_Append(sbHtml,"  </head>\r\n");
    CkStringBuilder_Append(sbHtml,"  <body bgcolor=\"#FFFFFF\" text=\"#000000\">\r\n");
    CkStringBuilder_Append(sbHtml,"    <p>This is a test.&nbsp; <img src=\"cid:CONTENT_ID\" height=\"20\" width=\"20\"></p>\r\n");
    CkStringBuilder_Append(sbHtml,"  </body>\r\n");
    CkStringBuilder_Append(sbHtml,"</html>\r\n");
    numReplacements = CkStringBuilder_Replace(sbHtml,"CONTENT_ID",CkStringBuilder_getAsString(sbContentId));

    // Create the HTML MIME part.
    htmlMime = CkMime_Create();
    CkMime_SetBodyFromHtml(htmlMime,CkStringBuilder_getAsString(sbHtml));
    CkMime_putEncoding(htmlMime,"8bit");
    CkMime_putCharset(htmlMime,"utf-8");

    // Load our JPG image from a file.
    fac = CkFileAccess_Create();
    jpgBytes = CkByteData_Create();
    success = CkFileAccess_ReadEntireFile(fac,"qa_data/jpg/starfish20.jpg",jpgBytes);

    // Create an image/jpeg MIME part.
    jpgMime = CkMime_Create();
    CkMime_SetBodyFromBinary(jpgMime,jpgBytes);
    // Setting the following properties has the effect of adding
    // the Content-Type, Content-Transfer-Encoding, and Content-Disposition header fields.
    // These header fields could also be set via the SetHeaderField method, in which case
    // the values of the affected properties would be updated.
    CkMime_putContentType(jpgMime,"image/jpeg");
    CkMime_putName(jpgMime,"starfish20.jpg");
    CkMime_putEncoding(jpgMime,"base64");
    CkMime_putDisposition(jpgMime,"inline");
    CkMime_putFilename(jpgMime,"starfish20.jpg");

    sbContentIdHdr = CkStringBuilder_Create();
    CkStringBuilder_Append(sbContentIdHdr,"<CONTENT_ID>");
    numReplacements = CkStringBuilder_Replace(sbContentIdHdr,"CONTENT_ID",CkStringBuilder_getAsString(sbContentId));
    CkMime_SetHeaderField(jpgMime,"Content-ID",CkStringBuilder_getAsString(sbContentIdHdr));

    // Add both parts as children of the multipart/related
    CkMime_AppendPart(mime,htmlMime);
    CkMime_AppendPart(mime,jpgMime);
    printf("%s\n",CkMime_getMime(mime));

    // --------------------------------------------------------------
    // --------------------------------------------------------------
    // This example builds the following MIME message.  The boundary
    // and Content-ID strings contain random data and will be different.  

    // Content-Type: multipart/related; boundary="------------A940F1230E6F0105F03DB2CB"
    // Subject: Test HTML email with JPG image.
    // 
    // --------------A940F1230E6F0105F03DB2CB
    // Content-Type: text/html; charset="utf-8"
    // Content-Transfer-Encoding: 8bit
    // 
    // <html><head>
    // <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    //   </head>
    //   <body bgcolor="#FFFFFF" text="#000000">
    //     <p>This is a test.&nbsp; <img src="cid:part1.E16AE3B4.1505C436@chilkatsoft.com" height="20" width="20"></p>
    //   </body>
    // </html>
    // 
    // --------------A940F1230E6F0105F03DB2CB
    // Content-Transfer-Encoding: base64
    // Content-Type: image/jpeg; name="starfish20.jpg"
    // Content-Disposition: inline; filename="starfish20.jpg"
    // Content-ID: <part1.E16AE3B4.1505C436@chilkatsoft.com>
    // 
    // /9j/4AAQSkZJRgABAQEASABIAAD//gAmRmlsZSB3cml0dGVuIGJ5IEFkb2JlIFBob3Rvc2hvcD8g
    // NC4w/9sAQwAQCwwODAoQDg0OEhEQExgoGhgWFhgxIyUdKDozPTw5Mzg3QEhcTkBEV0U3OFBtUVdf
    // YmdoZz5NcXlwZHhcZWdj/9sAQwEREhIYFRgvGhovY0I4QmNjY2NjY2NjY2NjY2NjY2NjY2NjY2Nj
    // Y2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2Nj/8IAEQgAFAAUAwERAAIRAQMRAf/EABcAAAMBAAAA
    // AAAAAAAAAAAAAAIDBAX/xAAYAQADAQEAAAAAAAAAAAAAAAABAgMEAP/aAAwDAQACEAMQAAAB2kZY
    // NNEijWKddfTmLgALWH//xAAbEAACAgMBAAAAAAAAAAAAAAABAgMRAAQSE//aAAgBAQABBQL0XqN+
    // pM2aqJGMiqFFCyg7z//EABwRAAICAgMAAAAAAAAAAAAAAAERAAIQIQMSUf/aAAgBAwEBPwHqU5aq
    // Axx+y1tMQl4elj//xAAcEQEAAQUBAQAAAAAAAAAAAAABEQACEBIhA1H/2gAIAQIBAT8B3Bhqy7Zc
    // enyiwmGgDhiOzj//xAAdEAABAwUBAAAAAAAAAAAAAAABAAIREBIhIkFR/9oACAEBAAY/ArZyn+Cg
    // xtxWuJaoCnqDuin/xAAcEAABBAMBAAAAAAAAAAAAAAABABEhYRAxQVH/2gAIAQEAAT8hkEwPUUR9
    // DYfE4nxtRpIkBTsayuALIiuY/9oADAMBAAIAAwAAABDWPTsf/8QAGhEAAwADAQAAAAAAAAAAAAAA
    // AAEREDFBIf/aAAgBAwEBPxC0DVPcWm+Ce4OesrkE6bjH/8QAGBEBAQEBAQAAAAAAAAAAAAAAAREA
    // QRD/2gAIAQIBAT8QahMiOc8YgSrnTY3ELclHXn//xAAcEAEBAAIDAQEAAAAAAAAAAAABEQAhMUFx
    // EFH/2gAIAQEAAT8Qn3igmSZSj+c4N4zapMy9IjFV98wncN2iuLFsCEbDGxQkI6RO/n//2Q==
    // 
    // --------------A940F1230E6F0105F03DB2CB--
    // 


    CkMime_Dispose(mime);
    CkCrypt2_Dispose(crypt);
    CkStringBuilder_Dispose(sbContentId);
    CkStringBuilder_Dispose(sbHtml);
    CkMime_Dispose(htmlMime);
    CkFileAccess_Dispose(fac);
    CkByteData_Dispose(jpgBytes);
    CkMime_Dispose(jpgMime);
    CkStringBuilder_Dispose(sbContentIdHdr);

    }