(Delphi ActiveX) Transition from MailMan.FetchByMsgnum to MailMan.FetchOne

Provides instructions for replacing deprecated FetchByMsgnum method calls with FetchOne.

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;
msgnum: Integer;
emailObj: IChilkatEmail;
headerOnly: Integer;
numBodyLines: Integer;
emailOut: TChilkatEmail;
success: Integer;

begin
mailman := TChilkatMailMan.Create(Self);

// ...
// ...

msgnum := 123;

// ------------------------------------------------------------------------
// The FetchByMsgnum method is deprecated:

emailObj := mailman.FetchByMsgnum(msgnum);
if (mailman.LastMethodSuccess = 0) then
  begin
    Memo1.Lines.Add(mailman.LastErrorText);
    Exit;
  end;

// ...
// ...

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

headerOnly := 0;
// Irrelevant because we are not downloading headers-only.
numBodyLines := 0;

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