Registry Configuration Service Provider Examples for OMA Client Provisioning

4/8/2010

Although the registry is directly accessible, accessing the registry through the metabase is the preferred method for updating settings. This is accomplished by using the configuration service provider specific to the settings that require an update.

For OMA Client Provisioning, querying the registry at the top level is not allowed. All parameters must be queried individually. The underlying data store of the Registry is typed. Be sure to use the datatype attribute of the <parm> tag.

This documentation describes the set of default characteristics. Additional characteristics may be added.

Because the Registry configuration service provider uses the backslash (\) character as a separator between key names, backslashes which occur in the name of a registry key must be escaped. Backslashes can be escaped by using two sequential backslashes (\\).

Note

Characteristics or parameters for the FileOperation, Metabase, and Registry configuration service providers can contain an additional attribute called "translation". The two values for this attribute are "filesystem" and "install". A translation of type "filesystem" causes all file paths to be canonicalized (that is, double backslashes are removed). A translation of type "install" includes all the translations done for "filesystem", but also translates all CE Strings (for example, %CE2%) into the correct file path for the device. Cabwiz will automatically add the appropriate translation to file operations and registry keys in an .inf file.

The following XML examples can be used as templates to configure settings for the Registry configuration service provider. Below the Registry characteristic type, replace the value for each parameter and characteristic type with values that correspond to your system.

For an XML example of the Registry configuration service provider that sends an error message regarding the display font size, see Provisioning File Error Messages.

For more information about changing the registry, see Changing Registry Settings by Using the Registry Configuration Service Provider and Querying Registry Settings by Using the Registry Configuration Service Provider.

See Also

Reference

Registry Configuration Service Provider

Concepts

Update or Add Settings to the Device