About registering a new domain for automatic configuration

Outlook provides a way to specify a new message service domain for automatic configuration and allow the message service provider to configure the account.

When designing a message service provider, you can use the following key in the Windows registry to specify a new domain to be automatically configured by the corresponding message service provider:

HKLM\Software\Microsoft\Office\Outlook\AutoConfigDomains\<domain name>\

In the key, <domain name> is the domain for automatic configuration. This domain name supports a wildcard * at the beginning only. The following table shows the values that this key supports.

Value Type Description
Friendly Name
REG_SZ
The domain name that is displayed to the user during automatic configuration.
Service Name
REG_SZ
The message service registered in mapisvc.inf that supports this domain.
Install Location
REG_SZ
The URL of the location to install the message service provider, if it is not already installed.
Minimum Version
REG_DWORD
The minimum version of the .dll of the message service provider that is required. This value is optional.

When Outlook begins automatic configuration for an email account, it checks the Windows registry for the registration of the domain specified by the email address. If the domain is already specified in the Windows registry, Outlook checks whether the message service is registered in Mapisvc.inf. Outlook cannot proceed with automatic configuration of the domain unless it has been specified in the Windows registry.

If the specified message service is not currently registered in Mapisvc.inf, or the message service provider is installed but the .dll has a version earlier than the specified minimum, Outlook uses the specified friendly name and prompts the user to install the provider. If the user accepts, Outlook redirects the user to the specified installation location so that the user can install the provider. Installing the provider registers the message service in Mapisvc.inf.

If the message service is currently registered in Mapisvc.inf and the service provider .dll is an appropriate version, Outlook creates the message service by using IMsgServiceAdmin::CreateMsgService, and then configures it by using IMsgServiceAdmin::ConfigureMsgService. Outlook automatic configuration uses the following three properties to allow the provider to set up the account: PidTagAutoConfigurationUserName, PidTagAutoConfigurationUserEmail, and PidTagAutoConfigurationUserPassword.

See also