

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.

Remember this is pre-release software and will have bugs and functional
limitations.  It is expected this release will allow development of 
applications for use in a test environment.  You will need to rebuild with
the final software when it is available to create your shipping product.
Do not distribute this code as final working code.

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
            Simple 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 of 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) Allocate at least 8k of stack space in the def file (set STACKSIZE = 8192)
    for your application to properly support UI

2) If you call cmc_act_on() with an extension for CMC_X_COM_SAVE_MESSAGE
    and the message structure passed in contains time_sent.month = 0,
    you may crash.

3) If a recipient exists on both the to: and cc: line of a message, the
    message saved to Sent Mail when the message is sent may contain
    multiple recipients in the from field

4) The Return receipt extension may not work.

5) The object identifier array for character sets returned from
    cmc_query_configuration() is not properly terminated.  For this release
    assume that there is only one object id returned in the array.

6) In the cmc_look_up() function, you must set the CMC_LAST_RECIP_LAST_ELEMENT
    flag in the first structure to ensure that only the first recipient
    is resolved when using the CMC_LOOKUP_RESOLVE_IDENTITY flag.

7) Extensions have not been thoroughly tested for this release, and should
    be considered unstable.

