README.TXT

MAPI Sample Simple Form 
 
 
The Simple.Frm sample application illustrates writing a form in C++. The form 
can be used by form-aware mail clients for sending/receiving messages of 
IPM.Note.Sample.Simple message class instead of standard send/read forms. 
 
Installation 
------------ 
 
The form has to be properly registered to be used by mail clients. Run 
pdkin32 -f smpfrm.cfg to register the form in the local form registry. Then 
run regedit smpfrm.reg to register smpfrm.exe as an OLE server for the form in 
the registry. The path to the form .EXE file has to be put in smpfrm.reg or 
into the PATH. 
  
Implementation 
-------------- 
 
The forms class CBaseForm supports the IMAPIForm, IPersistMessage, and 
IMAPIFormAdviseSink interfaces. Class CClassFactory implements IClassFactory. 
The form also implements two helper classes: CLastError and CViewNotifier to 
handle last error information and event notifications. 
 
If you would like to use the sample as a base for your own form, you'll need 
to change: 
 
 - File names. 
 - Form message class and class ID (in guid.h, smpfrm.reg, smpfrm.cfg). 
 - The Verbs and Extension sections and all the human readable information 
   in smpfrm.cfg. 
 - The UI and supporting functions. 
 - Implementation of all of the IPersistMessage methods, IMAPIForm::Doverb. 
 
Supported Features 
------------------ 
 
 - Send. 
 - Reply, Forward. 
 - Next, Previous. 
 - Save, Delete. 
 
Unsupported Features 
-------------------- 
 
 - Attachments. 
 - Reply All, Post. 
 - Move, Copy. 
 - Print. 
 
For unsupported features, you have a choice of either disabling them or 
delegating their execution to the form viewer. This is controlled by setting 
the appropriate fields of the Value variable in the [Extensions.1] section of 
the form .cfg file. Refer to MAPI Form Documentation for details.