Verifying Service Provider Configuration

Your logon method, either IABProvider::Logon, IMSProvider::Logon, or IXPProvider::TransportLogon, must verify your provider's configuration. This involves checking that all of the properties needed for full operation are set and set correctly. Every provider requires a different number of properties; configuration depends on your provider and the degree of user interaction you allow. Some service providers keep all of the necessary properties in the profile. Other service providers keep a partial set of properties in the profile and prompt the user for missing values. Still other providers do not store properties in the profile at all, relying on the user to supply all of the information needed for configuration.

    To retrieve properties stored in the profile

1. Call IMAPISupport::OpenProfileSection, passing the MAPIUID of your provider as an input parameter.
   1. Call the profile section's IMAPIProp::GetProps or GetPropList methods to retrieve individual properties or a property list.

    To set properties from user information

Display a property sheet, if MAPI has not set a flag prohibiting the display. The following flags indicate that a user interface cannot be presented.

If your provider does not store all of its configuration properties in the profile, requiring user interaction, and MAPI passes one of the dialog box suppression flags to your logon method, return MAPI_E_UNCONFIGURED. Also return this error when the dialog suppression flag is not set, but the user does not supply all of the required information.

When your service provider fails its logon method with MAPI_E_UNCONFIGURED, MAPI calls your entry point function again. If the information cannot be located with the second call, depending on how important your service provider is, the session might terminate.

The following illustration shows the logic required for configuration in your service provider logon method.