C
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 C Downloads
#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;
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 = 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. <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. <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);
}