

README File

Microsoft(R) Mail Electronic Mail for PC Networks, Version 3.2
Technical Reference

(C) Copyright Microsoft Corporation, 1992-1994


This README describes the following:
--The files included with Microsoft Mail that help you create custom 
commands and custom message types, and use MAPI functions.
--Corrections to the Technical Reference.


-----------------------------------------------------------------------
Supplied Files - Custom Commands
-----------------------------------------------------------------------

Several files included with Microsoft Mail help you create custom
commands. These files are in the \MAILEXTS directory of the drive 
path specified at installation (default = \WGTOOLS).

APPEXEC.DLL
Use this DLL to create custom commands that start another application
and pass information to it on the command line. You dont need to write
any additional code to try this DLL. 

EMPTYWB.DLL
This DLL implements a custom command that purges any messages in the 
Wastebasket folder. 

MAILEXTS.H
This C header file declares the Command function and the parameter block 
structure Mail passes to custom command DLLs. It also defines constant 
values used in some elements of the parameter block. For more 
information, see "DLL Parameter Block" in the Technical Reference.

MAILEXTS.TXT
This Visual Basic header file declares the Command function and the 
parameter block structure Mail passes to custom command DLLs. It also 
defines constant values used in some elements of the parameter block. 
For more information, see "DLL Parameter Block" in the Technical 
Reference.

SHARED.INI
This text file contains sample shared custom command declarations. For 
more information, see "Installing Shared Custom Commands" in the 
Technical Reference.

-----------------------------------------------------------------------
The following files are in the \MAILEXTS\APPEXEC subdirectory of the drive 
path specified during installation. For more information about how these 
files are used to build APPEXEC.DLL, see "Building a Sample DLL" in the 
Technical Reference.

APPEXEC
This is the makefile for APPEXEC.DLL.

APPEXEC.C
This file contains the C source code for APPEXEC.DLL.

APPEXEC.DEF
This is the linker definition file for APPEXEC.DLL.

APPEXEC.H
This is the APPEXEC header file for C containing definitions, functions, 
and source command line token information.

APPEXEC.TXT
This is the APPEXEC header file for Visual Basic containing definitions, 
functions, and source command line token information.

APPEXEC.RC
This is the Windows resource definition file for APPEXEC.DLL.


-----------------------------------------------------------------------
Supplied Files - Custom Message Types
-----------------------------------------------------------------------
Several files included with Microsoft Mail help you create custom
messages. These files are in the \MAILEXTS directory of the drive path 
specified during installation. 

APPEXEC.DLL
This DLL can be used to create custom message types. 

HELPREQ.EXE
This is the executable file for the HELPREQ message type. 

HELPREQ.INI
This file contains initialization information for the HELPREQ.EXE 
application.

MAILEXTS.H
This C header file declares the Command function and the parameter block 
structure Mail passes to custom message type DLLs. It also defines
constant values used in some elements of the parameter block. For more
information about this file, see "DLL Parameter Block" in the Technical 
Reference.

MAILEXTS.TXT
This Visual Basic header file declares the Command function and the 
parameter block structure Mail passes to custom message type DLLs. It 
also defines constant values used in some elements of the parameter 
block. For more information about this file, see "DLL Parameter Block" 
in the Technical Reference.

SHARED.INI
This text file contains a sample shared custom message type declaration. 
For more information, see "Installing Shared Custom Message Types" 
in the Technical Reference.

-----------------------------------------------------------------------
Several files in the \MAILEXTS\HELPREQ directory of the drive path 
specified at installation contain code for a sample Help Request
message type. For more information about how these files are used to build 
HELPREQ.EXE, see "Building a Sample Custom Message Type" in the Technical 
Reference.

HELPREQ
This is the make script for HELPREQ.EXE.

HELPREQ.C
This contains the C source code for HELPREQ.DLL.

HELPREQ.DEF
This is the linker definition file for HELPREQ.DLL.

HELPREQ.RC
This is the Windows resource definition file for HELPREQ.DLL.


-----------------------------------------------------------------------
Supplied Files - MAPI C
-----------------------------------------------------------------------
The following files are included with Microsoft Mail to help you use the
MAPI functions. They are in the \MAPI.C directory of the drive path 
specified during installation.
	
MAPI.H  
This C header file declares the simple MAPI functions and defines constant 
values returned on errors.

MAPIC.HLP
This is the online help executable for MAPI for C.

-----------------------------------------------------------------------
The following file is in the \MAPI.C\SAMPLE directory of the drive path 
specified at installation.

MAPIAPP.C
A sample C application that uses the MAPI C functions to perform various 
mail functions such as sending and receiving mail.  


-----------------------------------------------------------------------
Supplied Files - MAPI VB
-----------------------------------------------------------------------
The following files are included with Microsoft Mail to help you use the
MAPI functions. They are in the \MAPI.VB directory of the drive path 
specified during installation. Note that these files require version 2.0 
or greater of Visual Basic.

MAPIVB.BAS      
This BASIC file contains the support code for the simple MAPI Visual Basic 
functions.

MAPI.TXT        
This file contains global MAPI declarations to be copied to the global
declaration module when writing mail-enabled Visual Basic applications.

MAPIVB.HLP
The online help executable for MAPI for VB.

-----------------------------------------------------------------------
The following file is in the \MAPI.VB\SAMPLE directory of the drive path 
specified at installation.

MAPIDEMO.MAK
A sample VB 2.0 application that uses the MAPI Visual Basic functions to
perform various mail functions such as sending and receiving mail.  


-----------------------------------------------------------------------
Corrections to the Technical Reference  
-----------------------------------------------------------------------
Some return value names in the MAPI C and MAPI VB function descriptions 
in the Technical Reference do not match return value names in the MAPI.H 
and MAPI.TXT header files. 

These two return values are documented in the Technical Reference, but 
are not used and should be ignored:
	MAPI_E_NO_RECIP
	MAPI_E_BAD_RECIP        

These three return values are incorrectly documented in the Technical 
Reference:
	The Technical Reference uses    The header files use
	-----------------------------   ------------------------------ 
	MAPI_E_USER_ABORT               MAPI_USER_ABORT
	MAPI_E_AMBIG_RECIP              MAPI_E_AMBIGUOUS_RECIPIENT
	MAPI_E_LOGON_FAILURE            MAPI_E_LOGIN_FAILURE

Your applications should use the return value names listed in the header 
files. 
