

README

XAPIA Common Messaging Calls (CMC) Dynamic Link Library for use with
Microsoft(R) Mail Electronic Mail for PC Networks, Versions 3.00 and greater

(C) Copyright Microsoft Corporation, 1993

This disk contains a DLL, header files, sample code, and help file
documentation for creation of Mail enabled applications based on the
XAPIA Common Message Calls.  This DLL implements the full CMC spec including
the common extension set.  It also includes the proposed Microsoft extension
set.  Please contact us with any comments or problems as described below.

Contents:

        1) System Contents

        2) Installation

        3) Sample Code

        4) Support

        5) Issues and Problems


============================   SYSTEM CONTENTS  ===========================


cmc.dll     Dynamic link library with Common Messaging Call API

xcmc.h      Primary cmc header file

xcmcext.h   CMC Common extensions header file

xcmcmsxt.h  CMC Microsoft extensions header file

cmc.hlp     Help file for CMC API

sample directory
            Source code example of using CMC calls


============================    INSTALLATION   ===========================


1) Copy the files and sample directory from the disk to a directory on your
      system.
2) Move files to the following locations:
     cmc.dll to your path
     *.h files to your include path (not required for compiling sample)
3) Add the following lines to your [MAIL] section in win.ini
      CMC=1
      CMCDLLNAME=CMC.DLL

   NOTE: The line "MAPI=1" will already be present if a compatible version
      version of MSMail or Windows for Workgroups Mail is present.  If this
      line is not present, the cmc.dll should not be installed since the
      necessary support software will not be present.


============================    SAMPLE CODE   ===========================


1) Run the makefile from the samples directory to make the sample client
     application.  This can be run on top of your current MSMail system
     after carrying out the installation instructions above.  The client
     provides email client functionality based upon the CMC API.

2) See the included help file for complete documentation on writing software
     for use with the CMC DLL.


============================     SUPPORT    ===========================


Please report any comments or bugs to us by one of the following methods:
 a) Posting them to Section 17 of the MSWRKGRP forum on CompuServe 
 b) Mailing them through Internet to cmc@microsoft.com

=========================== ISSUES and PROBLEMS  ===========================


1) In order to maintain compatiblity with our Simple MAPI DLL, when the
    XAPIA CMC specification does not specifically state how something
    should be handled, we will follow the method used in that implementation.

2) Allocate at least 8k of stack space in the def file (set STACKSIZE = 8192)
    for your application to properly support UI

3) The extension sets supported by this release are CMC_XS_COM and CMC_XS_MS.
    These are both described in the help file provided with the release.

4) When using the CMC_X_MS_CONFIG_DATA extension with cmc_query_config, 
    valid parameters must be passed in the item and reference parameters.

5) In the CMC_X_MS_MESSAGE_DATA extension, the CMC_X_MS_MSG_RECEIPT_REQ
    flag will not automatically generate a read reciept report.  The flag
    will be passed to the receiving application which should generate
    the report.
