Platform SDK: MAPI

Supporting Message Service Installation

The setup program for installing your message service should:

  1. Copy message service files, such as the message service and service provider DLLs, from a CD or disk to a local drive on the workstation. The files that need to be copied depend on your message service. Typically you will copy at least one DLL.
  2. Add entries to the MAPISVC.INF configuration file. For information about how to modify this file to support the service providers in your message service, see File Format of MAPISVC.INF.
  3. Add entries as appropriate to the WIN.INI initialization file for 16-bit message services or the system registry for 32-bit message services. For details about the entries that should appear in the WIN.INI file or the system registry, see Installing MAPI.
  4. Create a default profile if one does not yet exist using one of the following:

Place the setup program in a designated public directory. This is important because most configuration clients, such as the Control Panel, require that users enter the name of the directory. The Control Panel invokes a setup program when a user clicks the Add button, invokes the Have Disk dialog box, and specifies the path to the program. The Control Panel runs the program and calls your message service's entry point function with the ulContext parameter set to MSG_SERVICE_INSTALL.

Warning  Because profiles are an expendable part of the MAPI architecture, make sure that your installation program does not store anything in the default profile that would be difficult to recreate. There are no utilities for profile recovery, for moving profiles from one machine to another, for off-line backup, or for individual or global restoration from backup copies.