README.TXT

Sample Property Sheet Extension 
 
 
SUMMARY 
======= 
 
The PropSh.Ext sample demonstrates how to implement custom property sheet 
extensions for the Microsoft Exchange Client. In particular, it demonstrates 
adding a custom property page that displays summary sheet information for 
Microsoft Office documents in a message store.  It adds the custom page when 
viewing properties with a message of class IPM.Document. 
 
 
MORE INFORMATION 
================ 
 
This sample requires Microsoft Windows NT 3.51 or Windows 95, the MAPI 1.0 
(Extended MAPI) PDK (Build 410 or above), Microsoft Visual C++ version 2.0 
(or later), and the Win32 SDK for Windows NT and Windows 95. 
 
To configure Exchange to use the client extension, place the following 
REG_SZ entry in the system registry in: 
HKEY_LOCAL_MACHINE\Software\Microsoft\Exchange\Client\Extensions: 
 
    Sample Property Extension=4.0;c:\<path>\EPRSHT32.DLL;1;00000000000100 
 
You can leave out an explicit path to EPRSHT32.DLL if it resides in a 
directory listed in the system's PATH. 
 
Exchange client extensions are designed using OLE's Component Object Model. 
The client calls methods which are provided in the extension. In some calls 
to the extension interface, a pointer to a callback interface 
(IExchExtCallback) for the extension to call back into the Exchange client. 
For more information read "Extending the Microsoft Exchange Client" in the 
MAPI PDK documentation. 
 
This sample implements two interface objects, IExchExt and 
IExchExtPropertySheets. The extension responds to IExchExtPropertySheets 
methods called by the Exchange client to append a property page if the selected 
message object is a IPM.Document class message. 
 
MAPI stores Microsoft Office documents as a set of properties with the 
summary sheet information is retained as named properties. The sample 
extracts the property IDs from the names the first time it displays the 
properties for an Office document with the GetIDsFromNames.  After that, it 
stores and reuses those ids until the Exchange client is closed. 
 
The summary info custom property page displays information in read-only edit 
controls. The information is read from pointers to elements of a SPropValue 
array filled by the GetProps function. If a particular property is not found, 
the string "No <property>" is diplayed in the corresponding field. The 
field will be blank if the property is found but is an empty string. Each time 
the summary info page is activated without closing the property sheet dialog, 
the controls are re-initialized with the same data. The SPropValue array is 
freed when the property sheet dialog is closed. 
 
The Help button is available for the summary info page and will display About 
information in the sample extension in a message box. 
 
To demonstrate the functionality of the extension, drag a Microsoft Office 
document that has summary sheet information into a folder in the Microsoft 
Exchange client. Then select the document and press Alt+ENTER or choose 
Properties... from the File menu in Exchange.