TEmail: MAPI component (V2.10.0)

Danny Heijl   [URL]

Stefan Hoffmeister   [URL]


TEmail is a non-visual component that allows you to send and receive e-mail on any Windows 3.x or Windows 95 or Windows NT PC that has MAPI-compatible e-mail provider software installed.

MAPI is an acronym for Microsoft's "Messaging Application Programming Interface".

Microsoft Mail, Microsoft Exchange, Microsoft Messaging client software, and Novell GroupWise client software are examples of MAPI providers.

They all supply "Simple MAPI" services via MAPI(32).DLL.

Note: If support for MAPI has not been installed on your system, you will not be able to test your application that uses TEmail!

You can develop without MAPI support though.

The component will also test the availability of MAPI at runtime.


  1. Installation Instructions
  2. Component Description
  3. History, Authors and Credits

1. Installation instructions :

1. Unzip Temail2.zip to a temporary directory
2. Copy compon\*.* to your component directory
3. Installation for
  • Delphi 1: Install email16.pas into your component library and rebuild the component library.
    Add email.kwf to your help system using helpinst.exe and copy email.hlp to the Delphi \BIN directory.
  • Delphi 2 and C++ Builder 1.0: Install email32.pas into your component library and rebuild the component library.
    Add email.kwf to your help system using helpinst.exe and copy email.hlp and email.cnt to the respective \BIN directory.
  • Delphi 3: Either install email32.pas into one of your user-defined packages, or open (File | Open) email3.dpk and press Install.
    Copy email.hlp and email.cnt to your Delphi \HELP directory, open DELPHI3.CFG in \HELP with a text editor and add to the end of this file the text:
      ; TEmail Help
      ;------------
      :Link email.hlp
    Finally delete DELPHI3.GID.
  • C++ Builder 3.0: Either install email32.pas into one of your user-defined packages, or open (File | Open) email3.bpk and press Install.

    Copy email.hlp and email.cnt to your C++ Builder \HELP folder, then Help | Customize... your online help to include this help file.

  • Delphi 4: Either install email32.pas into one of your user-defined packages, or open (File | Open) email4.dpk and press Install.

    Copy email.hlp and email.cnt to your Delphi 4 \HELP folder, then Help | Customize... your online help to include this help file.

4. From this moment on you can play with the provided demo applications.

You may want to have a look at the FAXDEMO directory, which contains another demonstration of how to use the component with MAPI Fax support.

Alternatively you can play with the "TEmail" component itself.


2. Component Description :

Published properties (design-time) :

Logon profile and password are not needed if you are already logged on.
If you are not logged on, you can leave them blank, a logon dialog box will pop up.

Public methods :

Public properties (runtime) :

Take care: If you set NoAttachments to false, then .ReadMail will put the attachments in a temp directory, and you have to delete them yourself, or call .CopyAttachment with the delete_after_copy flag set to True!


3. History:

More details can be found in the online help.

Original version 1.00.00 : Keith Darragh (c) SWIFTsoft 1995

Version 2.00.00, 2.00.0a, 2.00.0b: Danny Heijl:

Extended Keith's code sample to a fully functional MAPI component with demo application:

Version 2.00.0c:

Rudi Claasen:

  • added MAPI "address" dialog
  • Danny Heijl:

    Version 2.01.00: Stefan Hoffmeister:

    Version 2.02.00: Stefan Hoffmeister:

    Version 2.02.0a:

    Ismail Esmail

    Version 2.03.00:

    Danny Heijl:

    Changes to attachment code suggested by Roman Popov:

    Stefan Hoffmeister:

    Steve Pinneo :

    Version 2.04.00:

    Stefan Hoffmeister:

    Version 2.05.00:

    Danny Heijl:

    Version 2.05.01:

    Ulrik Schoth :

    Version 2.06.00:

    Stefan Hoffmeister:

    Version 2.07.00:

    Stefan Hoffmeister:

    Version 2.08.00:

    Stefan Hoffmeister:

    Version 2.08.01:

    Danny Heijl (never published):

    Version 2.09.00 - 2.09.02:

    Stefan Hoffmeister:

    Version 2.10.0:

    Stefan Hoffmeister:
    If you have added features to this component feel free to send them and they will probably be incorporated into future releases to the benefit of everybody.

    Last update: 1 November 1998