Changing Registry Settings by Using the Registry Configuration Service Provider

Article
08/28/2006

The preferred method for accessing the registry is by using the Configuration Service Providers. The Registry Configuration Service Provider allows you to change many registry settings that are not supported in other Configuration Service Providers.

Before you change registry settings, you may need to determine what the current registry settings are on the device. You can do this by using the Registry Configuration Service Provider to query the device. For more information see Querying Registry Settings by Using the Registry Configuration Service Provider.

The examples provided can be used as a template to configure settings for the Registry Configuration Service Provider. To use an example, you must replace the values as appropriate. To use an OMA DM example, you must also add the node as a child of the SyncBody node in an OMA DM provisioning file. For more information about the syntax of the provisioning file, see OMA DM Provisioning Files.

Note When using OMA DM to add a registry key, a child registry value must also be added in the XML code.

Changing a Registry setting using OMA DM Provisioning

The following example updates the home screen TimeOut setting.

<Replace>
      <CmdID>1</CmdID>
        <Item>
           <Meta>
            <Format xmlns="syncml:metinf">int</Format>
           </Meta>
          <Target>
               <LocURI>./Vendor/MSFT/Registry/HKCU/ControlPanel/Home/TimeOut</LocURI>
          </Target>
          
          <Data>600000</Data>
        </Item>
</Replace>

As shown in this example, you use the <Replace> element to change the current value of a Registry setting. To use this example as a template, you must change the following:

Change the information in the <LocURI> element to the correct path to the setting.

Note This is the path in the portion of the device DM tree that contains registry information. You must provide the entire path, including the root (./Vendor/MSFT/Registry/HKCU).
Change the information in the <Data> element to the new value.

Changing a Registry Setting Using OMA Client Provisioning

The following example updates the home screen timeout setting with a new value. <wap-provisioningdoc>

   <characteristic type="Registry">
      <characteristic type="HKCU\ControlPanel\Home">
         <parm name="TimeOut" value="600000" datatype="integer"/>
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

As shown in this example, the first <characteristic> element indicates that the Registry Configuration Service Provider will process this XML. To use this example as a template, you must change the following:

Change the information in the second <characteristic> element to the path in the Registry that you want to change. In this case, it is set to the Home screen settings.
Change the information in the name attribute of the <parm> element to the setting to be changed.
Change the information in the name attribute of the <parm> element to the setting to be changed.
Change the value attribute of the <parm> element to the new value.

Share via

Changing Registry Settings by Using the Registry Configuration Service Provider

See Also

Additional resources