Sample code for 30+ languages & platforms
Unicode C

Build a multipart/related MIME Message

See more MIME Examples

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

Chilkat Unicode C Downloads

Unicode C
#include <C_CkMimeW.h>
#include <C_CkCrypt2W.h>
#include <C_CkStringBuilderW.h>
#include <C_CkFileAccessW.h>
#include <C_CkByteData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMimeW mime;
    HCkCrypt2W crypt;
    HCkStringBuilderW sbContentId;
    HCkStringBuilderW sbHtml;
    int numReplacements;
    HCkMimeW htmlMime;
    HCkFileAccessW fac;
    HCkByteData jpgBytes;
    HCkMimeW jpgMime;
    HCkStringBuilderW sbContentIdHdr;

    success = FALSE;

    //  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 = CkMimeW_Create();

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

    //  Set a top-level MIME header field.
    CkMimeW_SetHeaderField(mime,L"Subject",L"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 = CkCrypt2W_Create();
    CkCrypt2W_putEncodingMode(crypt,L"hex");

    sbContentId = CkStringBuilderW_Create();
    CkStringBuilderW_Append(sbContentId,L"part1.");
    CkStringBuilderW_Append(sbContentId,CkCrypt2W_genRandomBytesENC(crypt,4));
    CkStringBuilderW_Append(sbContentId,L".");
    CkStringBuilderW_Append(sbContentId,CkCrypt2W_genRandomBytesENC(crypt,4));
    CkStringBuilderW_Append(sbContentId,L"@chilkatsoft.com");

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

    //  Create the HTML MIME part.
    htmlMime = CkMimeW_Create();
    CkMimeW_SetBodyFromHtml(htmlMime,CkStringBuilderW_getAsString(sbHtml));
    CkMimeW_putEncoding(htmlMime,L"8bit");
    CkMimeW_putCharset(htmlMime,L"utf-8");

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

    //  Create an image/jpeg MIME part.
    jpgMime = CkMimeW_Create();
    CkMimeW_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.
    CkMimeW_putContentType(jpgMime,L"image/jpeg");
    CkMimeW_putName(jpgMime,L"starfish20.jpg");
    CkMimeW_putEncoding(jpgMime,L"base64");
    CkMimeW_putDisposition(jpgMime,L"inline");
    CkMimeW_putFilename(jpgMime,L"starfish20.jpg");

    sbContentIdHdr = CkStringBuilderW_Create();
    CkStringBuilderW_Append(sbContentIdHdr,L"<CONTENT_ID>");
    numReplacements = CkStringBuilderW_Replace(sbContentIdHdr,L"CONTENT_ID",CkStringBuilderW_getAsString(sbContentId));
    CkMimeW_SetHeaderField(jpgMime,L"Content-ID",CkStringBuilderW_getAsString(sbContentIdHdr));

    //  Add both parts as children of the multipart/related
    CkMimeW_AppendPart(mime,htmlMime);
    CkMimeW_AppendPart(mime,jpgMime);
    wprintf(L"%s\n",CkMimeW_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--
    //  


    CkMimeW_Dispose(mime);
    CkCrypt2W_Dispose(crypt);
    CkStringBuilderW_Dispose(sbContentId);
    CkStringBuilderW_Dispose(sbHtml);
    CkMimeW_Dispose(htmlMime);
    CkFileAccessW_Dispose(fac);
    CkByteData_Dispose(jpgBytes);
    CkMimeW_Dispose(jpgMime);
    CkStringBuilderW_Dispose(sbContentIdHdr);

    }