(Delphi ActiveX) Access Attached Message (Embedded Email)

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

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

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

...

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

begin
email := TChilkatEmail.Create(Self);

// Load an email from a .eml
success := email.LoadEml('embeddedEmail.eml');
if (success <> 1) then
  begin
    Memo1.Lines.Add(email.LastErrorText);
    Exit;
  end;

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

// Get the 1st attached message.

email2 := email.GetAttachedMessage(0);
if (email.LastMethodSuccess = 1) then
  begin

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