Home Configuration Service Provider

4/8/2010

The Home Configuration Service Provider configures the Home screen on the device.

Note

This Configuration Service Provider is not available on Windows Mobile Professional or Windows Mobile Classic.

Note

This Configuration Service Provider can be managed over both the OMA Client Provisioning (formerly WAP Client Provisioning) and the OMA DM protocol.

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 about roles, see Security Roles and Default Roles for Configuration Service Providers.

The following table shows the default settings. The default security role maps to each subnode unless specific permission is granted to the subnode.

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

The following image shows the management object used by OMA DM.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Characteristics

• HKCU\ControlPanel\Home
  This characteristic must be present to change the style of the home screen.

Parameters

• BgImage
  This parm is used in the HKCU\ControlPanel\Home characteristic to set the Home screen background image on the device. The background image spinner then allows users to pick background images.

  The following table shows the default settings.

  Permissions	Read/write
  Data type	String
  Label	Background image:
  Roles allowed to query and update setting	Manager AuthenticatedUser UnauthenticatedUser

• ColorScheme
  This parm is used in the HKCU\ControlPanel\Home characteristic to set the color scheme for the device.

  The following table shows the default settings.

  Permissions	Read/write
  Data type	String
  Label	Color scheme:
  Roles allowed to query and update setting	Manager AuthenticatedUser UnauthenticatedUser

• DeleteScheme
  This parm identifies the Home screen scheme that is to be deleted. DeleteScheme only works on .tsk files in the \My Documents directory. The entire path for the file that will be removed must be specified in the value of this parm.

  The following table shows the default settings.

  Permissions	Read/write
  Data type	String
  Roles allowed to query and update setting	Manager AuthenticatedUser

• Scheme
  This parm is used in the HKCU\ControlPanel\Home characteristic to set the Home screen scheme.

  The following table shows the default settings.

  Permissions	Read/write
  Data type	String
  Label	Home screen layout:
  Roles allowed to query and update setting	Manager AuthenticatedUser UnauthenticatedUser

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements	Available
parm-query	Yes
noparm	No
nocharacteristic	No
characteristic-query	No

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

Home Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices