C
C
Send MIME Bytes from a BinData via SMTP
See more SMTP Examples
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 C Downloads
#include <C_CkMailMan.h>
#include <C_CkBinData.h>
void ChilkatSample(void)
{
BOOL success;
HCkMailMan mailman;
HCkBinData 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 = CkMailMan_Create();
// Configure the SMTP server connection.
CkMailMan_putSmtpHost(mailman,"smtp.example.com");
CkMailMan_putSmtpPort(mailman,465);
CkMailMan_putSmtpSsl(mailman,TRUE);
CkMailMan_putSmtpUsername(mailman,"user@example.com");
CkMailMan_putSmtpPassword(mailman,"myPassword");
// Load the MIME bytes to send. Here we read a .eml file, but the bytes could come from
// any source.
bdMime = CkBinData_Create();
success = CkBinData_LoadFile(bdMime,"qa_data/eml/message.eml");
if (success == FALSE) {
printf("%s\n",CkBinData_lastErrorText(bdMime));
CkMailMan_Dispose(mailman);
CkBinData_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 = CkMailMan_SendMimeBd(mailman,"alice@example.com","bob@example.com",bdMime);
if (success == FALSE) {
printf("%s\n",CkMailMan_lastErrorText(mailman));
CkMailMan_Dispose(mailman);
CkBinData_Dispose(bdMime);
return;
}
printf("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.
CkMailMan_Dispose(mailman);
CkBinData_Dispose(bdMime);
}