Share via


EMAIL Configuration Service Provider

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

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 EMAIL Configuration Service Provider is used for configuring Internet Protocol e-mail services on Windows Mobile 2002-based devices. While Pocket PC devices support multiple accounts, Smartphone devices can only be configured for either IMAP4 or POP3, but not both at the same time.

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

The following table shows the default settings.

Permissions Read/write
Roles allowed to query and update setting Manager

AuthenticatedUser

Characteristics

  • IMAP
    Specifies IMAP4 settings (Incoming mail server).
  • POP3
    Specifies POP3 settings (Incoming mail server).
  • SMTP
    Specifies SMTP user settings (Outgoing mail server).

Parms

  • AUTHNAME
    This parm contains the user login name (account name). This parm is used in the SMTP, IMAP4, and POP3 characteristics. If AUTHNAME is used in the SMTP characteristic, then the outgoing server (SMTP) requires authentication and the authentication is the same as it is for the incoming server (POP3 or IMAP4).
  • AUTHREQUIRED
    This Boolean parm is used in the SMTP characteristic to indicate that the outgoing server requires authentication. The same credentials that are used for the incoming mail server (specified in the IMAP or POP3 characteristic) are used for the outgoing server.
  • AUTHSECRET
    This parm is used in the IMAP4 and POP3 characteristics to hold the user's password. The same password is used for SMTP authorization if it is necessary.
  • CONNECTIONID
    This optional parm is used in the root EMAIL characteristic to specify the network connection GUID for the connection. This parm is required when sending an EMAIL provisioning XML file to the phone. If this parm is not included, a default connection is used.
  • DOMAIN
    This parm is used in the IMAP4 and POP3 characteristics to hold the user's domain name.
  • NAME
    This parm is used in the SMTP characteristic to hold the user's friendly name.
  • PXADDR
    This parm is used in the SMTP, IMAP4, and POP3 characteristics to hold the e-mail server.
  • REPLYADDR
    This parm is used in the SMTP characteristic to hold the user's reply e-mail address.
  • SERVICENAME
    This parm is used in the IMAP and POP3 characteristics to hold the name of the service. This name is displayed in the list of available accounts on Pocket PC devices.

Elements

Elements Available
parm-query Yes
noparm No
nocharacteristic No
characteristic-query Yes
recursive: Yes
root level of the Configuration Service Provider: Yes

For information about specific elements, see MSPROV DTD Elements.

See Also

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

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.