Delphi DLL

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 Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
mailman: HCkMailMan;
bdMime: HCkBinData;

begin
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) then
  begin
    Memo1.Lines.Add(CkBinData__lastErrorText(bdMime));
    Exit;
  end;

//  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) then
  begin
    Memo1.Lines.Add(CkMailMan__lastErrorText(mailman));
    Exit;
  end;

Memo1.Lines.Add('MIME email sent.');

//  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);