Creating a Profile through MAPI

This quick start procedure explains how to tailor profiles created to work with Microsoft Exchange Server. It is based on information about creating and configuring MAPI profiles in the Microsoft Exchange Client Extensions Programmer's Reference.

Design Tasks

In addition to the design tasks described in Creating and Configuring a Profile in the MAPI Programmer's Reference, you need to configure your new profile to be able to communicate with Microsoft Exchange Server. To do this, you need to know the name of the Home-Server and the mailbox name of your application. You also need to know whether the application for which the profile is being created will run as a service of Windows NT.

Implementation Tasks

Follow the steps in Creating and Configuring a Profile in the MAPI Programmer's Reference until you reach the step in which the MAPI IMsgServiceAdmin::ConfigureMsgService method is called. In this function call, specify the following information in the lpProps parameter. This parameter is a pointer to an SPropValue structure containing the values of the properties to display to the user in the property sheet.

• Home Server of the application's mailbox. Use the property tag PR_PROFILE_HOME_SERVER. This property is defined in EDKMDB.H.
• Name of the application's mailbox, using the property tag PR_PROFILE_MAILBOX. This property is defined in EDKMDB.H.
• If the application is to run as a service, set the profile property PR_CONVERSION_PROHIBITED (in MAPITAGS.H) to TRUE. Doing so keeps MAPI from displaying dialog boxes — in particular the Enter Password dialog box — at times when they cannot be responded to, such as when your application must run unattended. (Windows NT services, for example, are an important class of unattended applications.)

After this, finish the remaining steps in Creating and Configuring a Profile.

About Sample Source Code

None available at this time.