(Delphi DLL) Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, MailMan, Email;

...

procedure TForm1.Button1Click(Sender: TObject);
var
mailman: HCkMailMan;
email: HCkEmail;
success: Boolean;
contentType: PWideChar;

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

mailman := CkMailMan_Create();

CkMailMan_putSmtpHost(mailman,'smtp.my-mail-server.com');
CkMailMan_putSmtpUsername(mailman,'MY_SMTP_USERNAME');
CkMailMan_putSmtpPassword(mailman,'MY_SMTP_PASSWORD');
CkMailMan_putSmtpSsl(mailman,True);
CkMailMan_putSmtpPort(mailman,465);

email := CkEmail_Create();

CkEmail_putSubject(email,'This is a test');
CkEmail_putBody(email,'This is a test');
CkEmail_putFrom(email,'Chilkat Support <support@chilkatsoft.com>');
success := CkEmail_AddTo(email,'Chilkat Admin','admin@chilkatsoft.com');
// To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

// Add some attachments.
// The AddFileAttachment method returns the value of the content-type it chose for the attachment.
contentType := CkEmail__addFileAttachment(email,'qa_data/jpg/starfish.jpg');
if (CkEmail_getLastMethodSuccess(email) <> True) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Exit;
  end;
contentType := CkEmail__addFileAttachment(email,'qa_data/pdf/fishing.pdf');
if (CkEmail_getLastMethodSuccess(email) <> True) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Exit;
  end;

// If we save the email to a .eml, we can examine in a text editor.
success := CkEmail_SaveEml(email,'qa_output/e1.eml');
if (success = False) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Memo1.Lines.Add('Failed to save .eml');
    Exit;
  end;

// We see the following in the e1.eml
// Notice that Chilkat replaced the full path with just the filename.
// The full local path is not part of the email that gets sent..

// ...
// --------------020807050607070004010609
// Content-Type: image/jpeg; name="starfish.jpg"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="starfish.jpg"
// 
// ...
// --------------020807050607070004010609
// Content-Type: application/pdf; name="fishing.pdf"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="fishing.pdf"
// ...

// Before sending, each filename can be changed within the email object.
// For example:
success := CkEmail_SetAttachmentFilename(email,0,'orange_starfish.jpg');
success := CkEmail_SetAttachmentFilename(email,1,'tuna_fishing.pdf');

// Look at the new MIME source of the email in a  text editor...
success := CkEmail_SaveEml(email,'qa_output/e2.eml');
if (success = False) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Memo1.Lines.Add('Failed to save .eml');
    Exit;
  end;

// You'll see this:

// ...
// --------------020807050607070004010609
// Content-Type: image/jpeg; name="orange_starfish.jpg"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="orange_starfish.jpg"
// 
// ...
// --------------020807050607070004010609
// Content-Type: application/pdf; name="tuna_fishing.pdf"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="tuna_fishing.pdf"
// ...

// Send the email with the updated filenames..
success := CkMailMan_SendEmail(mailman,email);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkMailMan__lastErrorText(mailman));
    Exit;
  end;

success := CkMailMan_CloseSmtpConnection(mailman);
if (success <> True) then
  begin
    Memo1.Lines.Add('Connection to SMTP server not closed cleanly.');
  end;

Memo1.Lines.Add('Mail with attachments sent!');

CkMailMan_Dispose(mailman);
CkEmail_Dispose(email);

end;