(Delphi DLL) 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 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;
msgnum: Integer;
emailObj: HCkEmail;
headerOnly: Boolean;
numBodyLines: Integer;
emailOut: HCkEmail;
success: Boolean;

begin
mailman := CkMailMan_Create();

// ...
// ...

msgnum := 123;

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

emailObj := CkMailMan_FetchByMsgnum(mailman,msgnum);
if (CkMailMan_getLastMethodSuccess(mailman) = False) then
  begin
    Memo1.Lines.Add(CkMailMan__lastErrorText(mailman));
    Exit;
  end;

// ...
// ...

CkEmail_Dispose(emailObj);

// ------------------------------------------------------------------------
// 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 := False;
// Irrelevant because we are not downloading headers-only.
numBodyLines := 0;

emailOut := CkEmail_Create();
success := CkMailMan_FetchOne(mailman,headerOnly,numBodyLines,msgnum,emailOut);
if (success = False) then
  begin
    Memo1.Lines.Add(CkMailMan__lastErrorText(mailman));
    Exit;
  end;

CkMailMan_Dispose(mailman);
CkEmail_Dispose(emailOut);

end;