Unicode C

Send MIME Bytes from a BinData via SMTP

Demonstrates the Chilkat MailMan.SendMimeBd method, which sends an email from caller-supplied MIME bytes held in a BinData. The arguments are the from address, the recipient list (the SMTP envelope recipients), and the BinData containing the MIME. This example loads a .eml file into a BinData and sends it.

Important: When sending caller-supplied MIME, ensure the Message-ID header is unique for each message. Sending MIME whose Message-ID was previously used can cause the message to be silently discarded as a duplicate by mail servers — see chilkatsoft.com/email_duplicate_message_id.asp.

Background: This is the binary counterpart to SendMime (which takes MIME as a string). Working from a BinData is the right choice when the message's raw bytes come straight from a file, a database blob, or a network stream — it delivers them byte-for-byte with no charset conversion that could alter the original, which matters because MIME can carry binary transfer encodings.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkMailManW.h>
#include <C_CkBinDataW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailManW mailman;
    HCkBinDataW bdMime;

    success = FALSE;

    //  Demonstrates the MailMan.SendMimeBd method, which sends an email from caller-supplied MIME
    //  bytes held in a BinData.  The arguments are the from address, the recipient list (the SMTP
    //  envelope recipients), and the BinData containing the MIME.

    mailman = CkMailManW_Create();

    //  Configure the SMTP server connection.
    CkMailManW_putSmtpHost(mailman,L"smtp.example.com");
    CkMailManW_putSmtpPort(mailman,465);
    CkMailManW_putSmtpSsl(mailman,TRUE);
    CkMailManW_putSmtpUsername(mailman,L"user@example.com");
    CkMailManW_putSmtpPassword(mailman,L"myPassword");

    //  Load the MIME bytes to send.  Here we read a .eml file, but the bytes could come from
    //  any source.
    bdMime = CkBinDataW_Create();
    success = CkBinDataW_LoadFile(bdMime,L"qa_data/eml/message.eml");
    if (success == FALSE) {
        wprintf(L"%s\n",CkBinDataW_lastErrorText(bdMime));
        CkMailManW_Dispose(mailman);
        CkBinDataW_Dispose(bdMime);
        return;
    }

    //  IMPORTANT: When sending caller-supplied MIME, make sure the Message-ID header is unique
    //  for each message.  Sending MIME that contains a Message-ID that was previously sent can
    //  cause the message to be silently discarded as a duplicate by mail servers.  For details,
    //  see: https://www.chilkatsoft.com/email_duplicate_message_id.asp

    //  Send the MIME bytes to the envelope recipient(s).
    success = CkMailManW_SendMimeBd(mailman,L"alice@example.com",L"bob@example.com",bdMime);
    if (success == FALSE) {
        wprintf(L"%s\n",CkMailManW_lastErrorText(mailman));
        CkMailManW_Dispose(mailman);
        CkBinDataW_Dispose(bdMime);
        return;
    }

    wprintf(L"MIME email sent.\n");

    //  Note: The path "qa_data/eml/message.eml" is a relative local filesystem path,
    //  relative to the current working directory of the running application.

    //  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
    //  connects and authenticates -- using the property settings above -- whenever a server
    //  operation requires it.  Calling the explicit connect/authenticate methods can still be
    //  helpful to determine whether a failure occurs while connecting or while authenticating.


    CkMailManW_Dispose(mailman);
    CkBinDataW_Dispose(bdMime);

    }