(C) Convert HTML String to Email with Embedded Images

Converts an HTML string into an email with embedded images and sends. The HTML image may contain IMG tags with SRC attributes referencing images on the local filesystem or on the Web. The MHT component will gather all referenced images, style sheets, etc. regardless of whether they are located on the filesystem or the Web via an http or https URL.

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_CkMailMan.h>
#include <C_CkMht.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkMailMan mailman;
    HCkMht mht;
    HCkEmail email;
    const char *mime;
    BOOL success;

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

    mailman = CkMailMan_Create();

    // The MHT component can be used to convert an HTML page
    // from a URL, file, or in-memory HTML into an email
    // with embedded images and style sheets.
    mht = CkMht_Create();

    // There are two ways of embedding images in emails: with CIDs
    // and without.  When using CIDs, the IMG SRC attributes use
    // urls that begin with "cid:" and the corresponding image
    // embedded within the email includes a Content-ID header field.
    // When not using CIDs, the IMG SRC attribute can have a URL,
    // path, etc. and the corresponding image embedded within
    // the email has a matching Content-Location header field.

    // When testing with GMail, if CIDs are used the email will
    // be displayed with images blocked (by default) unless
    // the user allows them to be displayed.  Without CIDs,
    // the images are automatically displayed.

    // When testing with Eudora, Mozilla Thunderbird, and Outlook Express, 
    // embedded images display correctly with our without CIDs.

    // When testing with Yahoo! Mail, embedded images display OK.
    // However, the Yahoo! Mail user has the option of blocking
    // images.  If this is turned on, the CID images will still 
    // display correctly even though images are blocked.  Why?
    // It's because when viewing the email there is no external
    // HTTP request to fetch an image.  Therefore, a spammer 
    // cannot get an indication that you've read the email. 
    // However, if CIDs are not used, the images are blocked by 
    // any Yahoo! Mail user that has image blocking turned on --
    // even though the images are embedded.

    // I haven't tested Hotmail yet...
    // Regardless, there is no perfect solution.  If CIDs are used,
    // GMail users may block your embedded images, if CIDs are not
    // used, Yahoo! Mail users may block your embedded images.

    // I recommend setting using CIDs.  This is what Mozilla Thunderbird
    // does by default, and it's the more clear an unambiguous way
    // to indicate that images are indeed embedded.
    CkMht_putUseCids(mht,TRUE);

    // Create an email from an HTML file.
    // Call mht.HtmlToEML to get the MIME source of an email,
    // then load it into an email object.
    email = CkEmail_Create();

    mime = CkMht_htmlToEML(mht,"<html><body><p><b>Test Email</b><br><img src=\"http://www.chilkatsoft.com/images/dude.gif\"></body></html>");
    success = CkEmail_SetFromMimeText(email,mime);

    CkEmail_putSubject(email,"Test HTML email");

    // This example is tested in:
    // Outlook 2000, Eudora 7, Mozilla Thunderbird 1.5.0.9, Outlook Express 6, GMail, Yahoo Mail
    success = CkEmail_AddTo(email,"Chilkat Support","support@chilkatsoft.com");

    // Note: Chilkat does not regularly check our GMail and Yahoo
    // email accounts.  Please send support email to support@chilkatsoft.com
    success = CkEmail_AddTo(email,"Chilkat on Yahoo","chilkat_software@yahoo.com");
    success = CkEmail_AddTo(email,"Chilkat on GMail","chilkat.support@gmail.com");

    CkEmail_putFrom(email,"chilkat@live.com");

    // Send email using smtp.live.com
    CkMailMan_putSmtpHost(mailman,"smtp.live.com");
    CkMailMan_putSmtpUsername(mailman,"chilkat@live.com");
    CkMailMan_putSmtpPassword(mailman,"myPassword");
    CkMailMan_putSmtpPort(mailman,587);
    CkMailMan_putStartTLS(mailman,TRUE);

    // Send the email.
    success = CkMailMan_SendEmail(mailman,email);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkMht_Dispose(mht);
        CkEmail_Dispose(email);
        return;
    }

    printf("HTML Email Sent!\n");


    CkMailMan_Dispose(mailman);
    CkMht_Dispose(mht);
    CkEmail_Dispose(email);

    }