Pascal (Lazarus/Delphi)

Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Imap,
  Chilkat.Email;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  imap: TImap;
  cap: string;
  email: TEmail;
  uidNext: Integer;

begin
  success := False;

  //  This example assumes the Chilkat API to have been previously unlocked.
  //  See Global Unlock Sample for sample code.

  imap := TImap.Create;

  //  Connect to an IMAP server.
  //  Use TLS
  imap.Ssl := True;
  imap.Port := 993;
  success := imap.Connect('imap.example.com');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Login
  success := imap.Login('myLogin','myPassword');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Check the capabilities of the IMAP server.
  cap := imap.Capability();
  WriteLn('IMAP capabilities: ' + cap);

  //  If the capabilities string contains the substring "UIDPLUS", then 
  //  the UID of the appended email will be available in the AppendUid property (see below).

  //  For example, the GMail IMAP server has these capabilities (at this current time)
  //  * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
  //  X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
  //  APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

  email := TEmail.Create;

  //  Load the email from a .eml file.
  success := email.LoadEml('myEmail.eml');
  if (success <> True) then
    begin
      WriteLn(email.LastErrorText);
      Exit;
    end;

  success := imap.AppendMail('Inbox',email);
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  If the IMAP server supports the UIDPLUS extension, then the 
  //  imap.AppendUid will contain the UID of the appended email.
  //  Otherwise AppendUid will be 0.
  WriteLn('UID of appended email: ' + imap.AppendUid);

  //  If the IMAP server does NOT have UIDPLUS, then a program can 
  //  first select the mailbox, get the value of the UidNext property,
  //  and then append.  The appended email SHOULD have a UID equal to 
  //  the UidNext that was obtained just prior to appending (assuming no other
  //  program is simultaneously appending an email to the same mailbox).

  //  Note: It is not required to select a mailbox to append.  The select is only
  //  done for the purpose of obtaining the UIDNEXT value.
  success := imap.SelectMailbox('Inbox');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  uidNext := imap.UidNext;

  success := imap.AppendMail('Inbox',email);
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  WriteLn('The UID of the appended email SHOULD be ' + uidNext);

  WriteLn('Email uploaded to Inbox!');

  //  Disconnect from the IMAP server.
  success := imap.Disconnect();


  imap.Free;
  email.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.