EMAIL2 Configuration Service Provider

For mobile devices using Windows Mobile 2003 software or later, the EMAIL2 Configuration Service Provider configures Internet Protocol e-mail services (accounts). See the EMAIL Configuration Service Provider for information on how to configure e-mail services for Windows Mobile 2002-based devices.

Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.

The EMAIL2 Configuration Service Provider is used to configure e-mail accounts and query each configured e-mail account. In the event of a configuration failure, it is possible to roll back the transaction.

Note If you want to configure a mobile device so that it can use Server ActiveSync to synchronize all types of Microsoft Exchange server objects (rather than just e-mail), use the Sync Configuration Service Provider.

When you provision an application removal or configuration roll-back, the EMAIL2 Configuration Service Provider passes the request to Configuration Manager, which handles the transaction externally. When you remove a MAPI application, the accounts that were created with it are deleted. If you attempt to create a new e-mail account, and you are unsuccessful, the new account is automatically deleted. If you attempt to edit an existing account, and you are unsuccessful, the original configuration is automatically rolled back (restored).

Note All messages and other properties that the transport (Short Message Service [SMS], Post Office Protocol [POP], Simple Mail Transfer Protocol [SMTP], and so on) might have stored, are lost.

The following table shows the default settings.

Characteristics

• EMAIL2
  The encapsulating characteristic for all the other e-mail service provisioning elements (groups all e-mail services in the provisioning document).
• <GUID>
  Defines one specific e-mail account. This is a globally unique identifier (GUID) that you must generate for each new account.
• NAMEDPROPS
  Specifies that you are stating parameter element name attributes as nonstandard named properties.
• TAGPROPS
  Specifies that you are stating parameter element name attributes as nonstandard tag properties.

Parms

• AUTHNAME
  [Required] The name used to authorize the user to a specific e-mail account (also known as the user's logon name).
• AUTHREQUIRED
  [Optional] Specifies whether the outgoing server requires authentication (1 for true, and 0 for false).
• AUTHSECRET
  [Optional] The user's password. The same password is used for SMTP authentication.
• CONNECTIONID
  [Optional] The network connection GUID. The CONNECTIONID parm must appear immediately beneath the EMAIL2 characteristic. If you do not include the CONNECTIONID parm, the mobile device will attempt to find the best connection automatically.
• DOMAIN
  [Optional] The user's domain name.
• DWNDAY
  [Optional] Specifies how much e-mail to download. This is the number of days worth going back into the past.
• INSERVER
  [Required] The name of the messaging service's incoming e-mail server.
• KEEPMAX
  [Optional] Specifies the maximum size for a message's attachment (attachments beyond this size will remain on the server, but the message itself will be downloaded).
• LINGER
  [Optional] Specifies how frequently Microsoft Outlook performs scheduled send/receives (specified as the length of time in minutes, between updates).
• NAME
  [Optional] The display name associated with the user's e-mail account.
• OUTSERVER
  [Required] The name of the messaging service's outgoing e-mail server.
• REPLYADDR
  [Required] The user's reply e-mail address (usually the same as the user's e-mail address).
• RETRIEVE
  [Optional] Specifies the maximum size (in bytes) for messages retrieved from the incoming e-mail server. Messages beyond this size will still be retrieved, but will be truncated.
• SERVICENAME
  [Required] The name of the e-mail service to create or edit.
• SERVICETYPE
  [Required] The type of e-mail service to create or edit (such as IMAP4 or POP3).

Elements

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices| EMAIL2 Configuration Service Provider Examples

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.