RegistryPolicy.WriteListOfValues Method (RegistryHive, String, String, String[], RegistryValueKind, Boolean)
Writes a list of registry-based policy settings that configure String or ExpandString registry values. The registry values are specified by a value prefix and an array of value data; additive can be optionally specified.
Namespace: Microsoft.GroupPolicy
Assembly: Microsoft.GroupPolicy.Management (in Microsoft.GroupPolicy.Management.dll)
Syntax
public void WriteListOfValues(
RegistryHive hive,
string keyPath,
string valuePrefix,
string[] values,
RegistryValueKind type,
bool additive
)
public:
void WriteListOfValues(
RegistryHive hive,
String^ keyPath,
String^ valuePrefix,
array<String^>^ values,
RegistryValueKind type,
bool additive
)
member WriteListOfValues :
hive:RegistryHive *
keyPath:string *
valuePrefix:string *
values:string[] *
type:RegistryValueKind *
additive:bool -> unit
Public Sub WriteListOfValues (
hive As RegistryHive,
keyPath As String,
valuePrefix As String,
values As String(),
type As RegistryValueKind,
additive As Boolean
)
Parameters
hive
Type: Microsoft.Win32.RegistryHiveOne of the RegistryHive values that specifies the registry hive of the key. Specify CurrentUser to write policy settings to User Configuration. Specify LocalMachine to write policy settings to Computer Configuration. No other values are supported.
keyPath
Type: System.StringThe path to the registry key.
valuePrefix
Type: System.StringA string that specifies the value name prefix for the registry values. For example, if “MyValue” is specified, registry-based policy settings are created for the following value names: “MyValue1”, “MyValue2”, “MyValue3”, and so on depending on the length of the array that is specified for the values parameter.
values
Type: System.String[]An array of strings that contains the value data.
type
Type: Microsoft.Win32.RegistryValueKindOne of the RegistryValueKind enumeration values that specifies the data type for the registry values. Only ExpandString and String are supported.
additive
Type: System.Booleantrue for additive; otherwise false.
Exceptions
Exception | Condition |
---|---|
ObjectDisposedException | The RegistryPolicy is disposed. |
InvalidOperationException | The RegistryPolicy instance is read-only. |
ArgumentNullException | keyPath is null -or- values is null |
ArgumentException | keyPath is an empty string (“”) -or- values is an empty string (“”) -or- hive is not CurrentUser or LocalMachine -or- type is not ExpandString or String |
See Also
WriteListOfValues Overload
RegistryPolicy Class
Microsoft.GroupPolicy Namespace
Return to top