Get IMAP Attachment Filenames

See more IMAP Examples

Demonstrates the Chilkat Imap.GetMailAttachFilename method, which returns the filename of an attachment. The first argument is the Email and the second is the zero-based attachment index. This example fetches only the message headers and lists the attachment filenames.

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;
  headersOnly: Boolean;
  useUid: Boolean;
  seqNum: Integer;
  email: TEmail;
  numAttach: Integer;
  i: Integer;
  fname: string;

begin
  success := False;

  //  Demonstrates the Imap.GetMailAttachFilename method, which returns the filename of an
  //  attachment.  The 1st argument is the Email and the 2nd is the zero-based attachment index.

  imap := TImap.Create;

  imap.Ssl := True;
  imap.Port := 993;

  success := imap.Connect('imap.example.com');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;
  success := imap.Login('user@example.com','myPassword');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  success := imap.SelectMailbox('Inbox');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Fetch only the message headers.  Attachment bodies are NOT downloaded, but the ckx-imap-*
  //  metadata describing the attachments is present, so the attachment info methods still work.
  headersOnly := True;
  useUid := False;
  seqNum := 1;
  email := TEmail.Create;
  success := imap.FetchEmail(headersOnly,seqNum,useUid,email);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Loop over the attachments and print each filename.
  numAttach := imap.GetMailNumAttach(email);
  WriteLn('Attachments: ' + numAttach);

  for i := 0 to numAttach - 1 do
    begin
      //  GetMailAttachFilename returns a string, so assign it to a string variable.
      fname := imap.GetMailAttachFilename(email,i);
      if (imap.LastMethodSuccess = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;
      WriteLn(fname);
    end;

  success := imap.Disconnect();
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;


  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.