Simple MAPI VCL 
---------------

The file MAPICTRL.ZIP includes the following files:

MAPI.DCR          Resource file for MAPI.DCU
MAPI.DCU          Unit containing TMapiSession and TMapiMessage
MAPICTRL.HLP      Help file for TMapiSession and TMapiMessage
MAPICTRL.KWF      A keyword file for merging MAPICTRL.HLP into Delphi's help system

MAIN.PAS          MAIN unit for MAPITEST.DPR
MAIN.DFM          Main form for MAPITEST.DPR
MAPITEST.DPR      Sample project using TMapiSession and TMapiMessage
MAPITEST.EXE      Demonstration Program
MAPITEST.RES      Resources for MAPITEST.DPR

README.TXT        This file!


Installation
------------

Install MAPI just as you would any other VCL component:

1) Copy MAPI.DC* into your DELPHI\LIB directory
2) Within Delphi, choose "Install Components"
3) Follow the directions as indicated in the online help (search for "Installing")
4) Use HELPINST.EXE to merge the help files
5) Copy the sample project and its files (MAIN.*, MAPITEST.*) to a convenient directory

Notes
-----

Delphi is a wonderful programming environment and is superior to Visual basic in many
ways.  A serious problem, however, is Delphi's lack of MAPI support and its inability
to use the MSMAPI.VBX that all us VB developers know and love.  I wrote MAPI.DCU to try
to fix this limitation.

MAPI.DCU is designed to provide a simple method to add basic messaging capabilities to
Delphi programs.  It provides most all of the functionality known as "Simple MAPI";
certain features have been intentionally omitted to preserve simplicity and reliability.
Using MAPI.DLL requires more knowledge of pointers, dynamic memory allocation, etc. than
most visual programmers care to know about.  MAPI.DCU attempts to encapsulate everything
in easy-to-use, standard VCL pieces.

MAPI.DCU provides two components: TMapiSession and TMapiMessage (those of you familiar with
Visual Basic will recognize the two-control format that I used as a model).  Both contain
only a few properties and methods; neither has any events.  Their usage is fully detailed
in the included help file (MAPICTRL.HLP).

These components have been tested under Windows 3.1, Windows for Workgroups 3.11, and Windows
NT (versions 3.5 and 3.51) using the file MAPI.DLL provided with Windows for Workgroups and
Microsoft Mail.

Registration
------------

As always, there's a catch.  This version of MAPI.DCU will display an annoying dialog box
every time you read or send mail (Call it nagware, crippleware, whatever - I call it paying
the rent...).  If you want to make the dialogs go away then send a check for $25 to:

   Corey Bodzin  (payable to me!)
   3189 Onaway Rd.
   Shaker Heights, Ohio  44120

When you register you get:

1) A registered component that doesn't nag you (MAPI.DCU)
2) Full source code for the components (MAPI.PAS) and the help file (MAPI.RTF) that you
   may modify as you please
3) The undying gratitude of my landlord, credit card companies, and everybody I owe money

With your check, please indicate how you would like the files sent:

1) By snail-mail on 3.5" floppy
2) To your Internet e-mail address (please specify UUEncode or MIME)
3) To your CompuServe e-mail address 

Finally
-------

I have tried to be as thorough as I can with testing and debugging, but you may still find a 
bug or a better way to do something.  E-mail me any problems or suggestions to:

     Internet:     cbodzin@interserv.com
   CompuServe:     74034,62 (Corey Bodzin)

Now for the lawyer stuff:

   THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS,
   IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL COREY
   BODZIN BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES
   OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
   PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY
   OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
   SOFTWARE.

   I AM NOT RESPONSIBLE FOR THE NATIONAL DEBT.  I IN NO WAY ASSUME RESPONSIBILITY FOR
   BARNEY, THE FRENCH OBSESSION WITH JERRY LEWIS, OR TOFU.  I AM BLAMELESS IN ALL
   CIRCUMSTANCES AND HAVE A HALO OVER MY HEAD AT ALL TIMES.  SUE SOMEBODY ELSE.


*** End of File ***