(Delphi DLL) Access Attached Message (Embedded Email)

How to access an email embedded within another email (i.e. an attached message).

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, Email;

...

procedure TForm1.Button1Click(Sender: TObject);
var
email: HCkEmail;
success: Boolean;
numAttached: Integer;
email2: HCkEmail;

begin
email := CkEmail_Create();

// Load an email from a .eml
success := CkEmail_LoadEml(email,'embeddedEmail.eml');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkEmail__lastErrorText(email));
    Exit;
  end;

// Display how many attached emails are embedded within
// this one:
numAttached := CkEmail_getNumAttachedMessages(email);
Memo1.Lines.Add('numAttached = ' + IntToStr(numAttached));

// Get the 1st attached message.

email2 := CkEmail_GetAttachedMessage(email,0);
if (CkEmail_getLastMethodSuccess(email) = True) then
  begin

    // Display the subject, From, and a header field...
    Memo1.Lines.Add(CkEmail__subject(email2));
    Memo1.Lines.Add(CkEmail__from(email2));
    Memo1.Lines.Add(CkEmail__getHeaderField(email2,'X-SOMETHING'));
  end;

CkEmail_Dispose(email);

end;