Partager via

Home Configuration Service Provider

  • Article

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.

Bb737641.cabbcbe5-ce7a-453e-91fc-f574c74567e2(en-us,MSDN.10).gif

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

Bb737641.670c6592-df19-44c0-be84-4b5c7a57c127(en-us,MSDN.10).gif

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