RegistryPolicy.Read Method (RegistryHive, String, String)

Reads the registry-based policy setting that configures a specified registry value.

Namespace: Microsoft.GroupPolicy
Assembly: Microsoft.GroupPolicy.Management (in Microsoft.GroupPolicy.Management.dll)

Syntax

public ReadOnlyCollection<RegistryItem> Read(
    RegistryHive hive,
    string keyPath,
    string valueName
)

public:
ReadOnlyCollection<RegistryItem^>^ Read(
    RegistryHive hive,
    String^ keyPath,
    String^ valueName
)

member Read : 
        hive:RegistryHive *
        keyPath:string *
        valueName:string -> ReadOnlyCollection<RegistryItem>

Public Function Read (
    hive As RegistryHive,
    keyPath As String,
    valueName As String
) As ReadOnlyCollection(Of RegistryItem)

hive
Type: Microsoft.Win32.RegistryHive

One of the RegistryHive values that specifies the registry hive of the key. Specify CurrentUser to read policy settings from User Configuration. Specify LocalMachine to read policy settings from Computer Configuration. No other values are supported.

valueName
Type: System.String

The name of the registry value. You can specify an empty string (“”) for the default value.

Returns ReadOnlyCollection<T>. A read-only collection of RegistryItem objects that contains the registry-based policy settings.

Exception	Condition
ObjectDisposedException	The RegistryPolicy is disposed.
InvalidOperationException	The RegistryPolicy instance is read-only.
ArgumentNullException	keyPath is null
ArgumentException	keyPath is an empty string (“”) -or- hive is not CurrentUser or LocalMachine