Registry Provider

Updates, queries, and enumerates Microsoft® Windows® registry keys and values on a local or remote computer. Used by Microsoft Provisioning Framework (MPF).

Caution should be taken when implimenting any solution that takes advantage of the Registry provider. For Registry Provider security considerations, see Registry Provider Security Considerations.

Implementation

Program Files\Microsoft Provisioning\Providers\MPFRegistryProv.dll

Properties
Name Registry Provider
Version 1
Provider Source Provisioning.RegistryProvider.1
Errors

The following table lists the errors returned by this provider.

HRESULT Description
0xC2101068L Invalid 'ace' sub-element name '%1'.
0xC2101069L The 'ace' sub-element '%1' has an invalid value of '%2'.
0xC210106AL Missing 'ace' sub-element '%1'.
0xC210106BL Only one 'ace' sub-element named '%1' is allowed per 'ace'.
0xC210106CL The 'ace' sub-element 'trusteeForm' does not specify an object, but an object was specified.
0xC210106DL The provided ACL was rejected by SetEntriesInAcl.
0xC210106EL %1.
0xC2101839L Failed to get the registry value specified. Machine:'%1', Rootkey:'%2', Subkey:'%3', Item:'%4'.
0xC210183AL Failed to set the registry value specified. Machine:'%1', Rootkey:'%2', Subkey:'%3', Item:'%4'.
0xC210183BL Unable to roll back a set of a registry value.
0xC210183CL Unable to delete registry value specified. Machine:'%1', Rootkey:'%2', Subkey:'%3', Item:'%4'.
0xC210183DL Unable to roll back a delete of a registry value.
0xC210183EL Unable to enumerate registry value for specified input. Machine:'%1', Rootkey:'%2', Subkey:'%3'.
0xC210183FL Unable to create specified registry key. Machine:'%1', Rootkey:'%2', Subkey:'%3'.
0xC2101840L Unable to delete specified registry key. Machine:'%1', Rootkey:'%2', Subkey:'%3'.
0xC2101841L Unable to enumerate specified registry key. Machine:'%1', Rootkey:'%2', Subkey:'%3'.
0xC2101842L Unable to roll back a creation of registry key.
0xC2101843L Unable to roll back a deletion of registry key.
Public Methods
Procedure Description
CreateRegKey Creates a new registry key (based on a given machine, root key, and subkey).
CreateRegKeyWithSecurity Creates a registry key and sets values for its security discretionary access control lists (DACLs). CreateRegKeyWithSecurity is a namespace-only procedure that executes CreateRegKey and .
DeleteRegKey Deletes a registry subkey and all its descendants, along with their values.
DeleteRegValue Deletes a named value for a specific registry item.
Executes a shallow (nonrecursive) enumeration of a specified registry key (machine, location, subkey).
EnumRegValue Enumerates the values beneath a specified registry key.
GetRegKeySecurity Obtains the discretionary access control list (DACL) security settings for a registry key. GetRegKeySecurity is a namespace-only procedure that executes Active Directory Provider::Get DACL.
GetRegValue Retrieves the value for a specific registry item.
SetRegKeySecurity Sets the discretionary access control list (DACL) security settings for a registry key. SetRegKeySecurity is a namespace-only procedure that executes Active Directory Provider::Update ACL.
SetRegValue Sets a registry value to a specific item.
 Applies To