(Delphi ActiveX) Transition from MailMan.FetchSingleHeaderByUidl to MailMan.FetchByUidl

Provides instructions for replacing deprecated FetchSingleHeaderByUidl method calls with FetchByUidl.

Note: This example requires Chilkat v11.0.0 or greater.

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
mailman: TChilkatMailMan;
numBodyLines: Integer;
uidl: WideString;
emailObj: IChilkatEmail;
headerOnly: Integer;
emailOut: TChilkatEmail;
success: Integer;

begin
mailman := TChilkatMailMan.Create(Self);

// ...
// ...

numBodyLines := 5;
uidl := '123';

// ------------------------------------------------------------------------
// The FetchSingleHeaderByUidl method is deprecated:

emailObj := mailman.FetchSingleHeaderByUidl(numBodyLines,uidl);
if (mailman.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(mailman.LastErrorText);
    Exit;
  end;

// ...
// ...

// ------------------------------------------------------------------------
// Do the equivalent using FetchByUidl.
// Your application creates a new, empty Email object which is passed 
// in the last argument and filled upon success.

headerOnly := 1;

emailOut := TChilkatEmail.Create(Self);
success := mailman.FetchByUidl(uidl,headerOnly,numBodyLines,emailOut.ControlInterface);
if (success = 0) then
  begin
    Memo1.Lines.Add(mailman.LastErrorText);
    Exit;
  end;
end;