windows-itpro-docs/windows/client-management/mdm/registry-csp.md

title, description, ms.assetid, ms.reviewer, manager, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date

title	description	ms.assetid	ms.reviewer	manager	ms.author	ms.topic	ms.prod	ms.technology	author	ms.date
Registry CSP	In this article, learn how to use the Registry configuration service provider (CSP) to update registry settings.	2307e3fd-7b61-4f00-94e1-a639571f2c9d		dansimp	dansimp	article	w10	windows	manikadhiman	06/26/2017

Registry CSP

The Registry configuration service provider is used to update registry settings. However, if there is configuration service provider that is specific to the settings that need to be updated, use the specific configuration service provider.

Note

The Registry CSP is only supported in Windows 10 Mobile for OEM configuration. Do not use this CSP for enterprise remote management. For Windows 10 Mobile only, this configuration service provider requires the ID_CAP_CSP_FOUNDATION and ID_CAP_CSP_OEM capabilities to be accessed from a network configuration application.

 

For the Registry CSP, you cannot use the Replace command unless the node already exists.

The Registry configuration service provider can be managed over both the OMA Client Provisioning and the OMA DM protocol. When using OMA DM to add a registry key, a child registry value must also be added in the XML code.

For OMA Client Provisioning, the follows notes apply:

• 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 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 (\\).

The default security role maps to each subnode unless specific permission is granted to the subnode. The security role for subnodes is implementation specific, and can be changed by OEMs and mobile operators.

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	Yes
nocharacteristic	Yes
characteristic-query	Yes Recursive query: Yes Top level query: No

  Use these elements to build standard OMA Client Provisioning configuration XML. For information about specific elements, see MSPROV DTD elements.

Supported Data Types

The following table shows the data types this configuration service provider supports.

XML Data Type	Native Registry Type	XML Format
integer	REG_DWORD	Integer. A query of this parameter returns an integer type.
boolean	REG_DWORD	Integer value of 1 or 0. A query of this parameter returns an integer type.
float	REG_SZ	Float. A query of this parameter returns a string type.
string	REG_SZ	String. A query of this parameter returns a string type.
multiplestring	REG_MULTI_SZ	Multiple strings are separated by  and ended with two  - A query of this parameter returns a multistring type.
binary	REG_BINARY	Base64 encoded. A query of this parameter returns a binary type.
time	FILETIME in REG_BINARY	The time format conforms to the ISO8601 standard, with the date portion optional. If the date portion is omitted, also omit the "T" delimiter. A query of this parameter returns a binary type.
date	FILETIME in REG_BINARY	The date format conforms to the ISO8601 standard, with the time portion optional. If the time portion is omitted, also omit the "T" delimiter. A query of this parameter returns a binary type.

 

It is not possible to access registry keys nested under the current path by using the Registry configuration service provider. Instead, the values of the subkey must be accessed separately by using a new characteristic.

Related topics

Configuration service provider reference