Home Configuration Service Provider

  • Article

Send Feedback

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

Note   This Configuration Service Provider is not available on Windows Mobile-based Pocket PCs.

Note   This Configuration Service Provider can be managed over both the OMA Client Provisioning (formerly WAP) 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) 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

Configuration Service Provider Reference for Windows Mobile-Based Devices | Home Configuration Service Provider Examples for OMA Client Provisioning

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.