RegistryKey.CreateSubKey Method (String, RegistryKeyPermissionCheck)
Creates a new subkey or opens an existing subkey for write access, using the specified permission check option.
Assembly: mscorlib (in mscorlib.dll)
[ComVisibleAttribute(false)] public RegistryKey CreateSubKey( string subkey, RegistryKeyPermissionCheck permissionCheck )
- Type: System.String
The name or path of the subkey to create or open. This string is not case-sensitive.
- Type: Microsoft.Win32.RegistryKeyPermissionCheck
One of the enumeration values that specifies whether the key is opened for read or read/write access.
subkey is null.
The user does not have the permissions required to create or open the registry key.
permissionCheck contains an invalid value.
The RegistryKey on which this method is being invoked is closed (closed keys cannot be accessed).
The RegistryKey cannot be written to; for example, it was not opened as a writable key, or the user does not have the necessary access rights.
The nesting level exceeds 510.
A system error occurred, such as deletion of the key, or an attempt to create a key in the LocalMachine root.
In order to perform this action, the user must have permission at this level and below in the registry hierarchy.
Do not expose RegistryKey objects in such a way that a malicious program could create thousands of meaningless subkeys or key/value pairs. For example, do not allow callers to enter arbitrary keys or values.
for the ability to modify the specified registry key if it exists, or for the ability to create the registry key if it does not already exist. Associated enumerations: RegistryPermissionAccess.Write, RegistryPermissionAccess.Create
for the ability to access the specified registry key if it is a remote key. Associated enumeration: SecurityPermissionFlag.UnmanagedCode
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.