Sdílet prostřednictvím


RegistryKey.CreateSubKey Metoda

Definice

Vytvoří nový podklíč nebo otevře existující podklíč.

Přetížení

CreateSubKey(String)

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis.

CreateSubKey(String, RegistryKeyPermissionCheck)

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis pomocí zadané možnosti kontroly oprávnění.

CreateSubKey(String, Boolean)

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis pomocí zadané možnosti kontroly oprávnění a zabezpečení registru.

CreateSubKey(String, Boolean, RegistryOptions)

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Vytvoří podklíč nebo otevře podklíč pro přístup pro zápis pomocí zadané kontroly oprávnění a možností registru.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Vytvoří podklíč nebo otevře podklíč pro přístup pro zápis pomocí zadané možnosti kontroly oprávnění, možnosti registru a zabezpečení registru.

CreateSubKey(String)

Zdroj:
RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey);
member this.CreateSubKey : string -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Výjimky

subkey je null.

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

Do objektu RegistryKey nelze zapisovat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu o vytvoření klíče v kořenovém adresáři LocalMachine .

Příklady

Následující příklad kódu ukazuje, jak vytvořit podklíč pod HKEY_CURRENT_USER, manipulovat s jeho obsahem a poté podklíč odstranit.

using namespace System;
using namespace System::Security::Permissions;
using namespace Microsoft::Win32;

int main()
{
   // Create a subkey named Test9999 under HKEY_CURRENT_USER.
   RegistryKey ^ test9999 = Registry::CurrentUser->CreateSubKey( "Test9999" );

   // Create two subkeys under HKEY_CURRENT_USER\Test9999.
   test9999->CreateSubKey( "TestName" )->Close();
   RegistryKey ^ testSettings = test9999->CreateSubKey( "TestSettings" );

   // Create data for the TestSettings subkey.
   testSettings->SetValue( "Language", "French" );
   testSettings->SetValue( "Level", "Intermediate" );
   testSettings->SetValue( "ID", 123 );
   testSettings->Close();

   // Print the information from the Test9999 subkey.
   Console::WriteLine( "There are {0} subkeys under Test9999.", test9999->SubKeyCount.ToString() );
   array<String^>^subKeyNames = test9999->GetSubKeyNames();
   for ( int i = 0; i < subKeyNames->Length; i++ )
   {
      RegistryKey ^ tempKey = test9999->OpenSubKey( subKeyNames[ i ] );
      Console::WriteLine( "\nThere are {0} values for {1}.", tempKey->ValueCount.ToString(), tempKey->Name );
      array<String^>^valueNames = tempKey->GetValueNames();
      for ( int j = 0; j < valueNames->Length; j++ )
      {
         Console::WriteLine( "{0,-8}: {1}", valueNames[ j ], tempKey->GetValue( valueNames[ j ] )->ToString() );

      }
   }
   
   // Delete the ID value.
   testSettings = test9999->OpenSubKey( "TestSettings", true );
   testSettings->DeleteValue( "id" );

   // Verify the deletion.
   Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue(  "id", "ID not found." )) );
   testSettings->Close();

   // Delete or close the new subkey.
   Console::Write( "\nDelete newly created registry key? (Y/N) " );
   if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y' )
   {
      Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
      Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name );
   }
   else
   {
      Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString() );
      test9999->Close();
   }
}
using System;
using System.Security.Permissions;
using Microsoft.Win32;

class RegKey
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 =
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        using(RegistryKey
            testName = test9999.CreateSubKey("TestName"),
            testSettings = test9999.CreateSubKey("TestSettings"))
        {
            // Create data for the TestSettings subkey.
            testSettings.SetValue("Language", "French");
            testSettings.SetValue("Level", "Intermediate");
            testSettings.SetValue("ID", 123);
        }

        // Print the information from the Test9999 subkey.
        Console.WriteLine("There are {0} subkeys under {1}.",
            test9999.SubKeyCount.ToString(), test9999.Name);
        foreach(string subKeyName in test9999.GetSubKeyNames())
        {
            using(RegistryKey
                tempKey = test9999.OpenSubKey(subKeyName))
            {
                Console.WriteLine("\nThere are {0} values for {1}.",
                    tempKey.ValueCount.ToString(), tempKey.Name);
                foreach(string valueName in tempKey.GetValueNames())
                {
                    Console.WriteLine("{0,-8}: {1}", valueName,
                        tempKey.GetValue(valueName).ToString());
                }
            }
        }

        using(RegistryKey
            testSettings = test9999.OpenSubKey("TestSettings", true))
        {
            // Delete the ID value.
            testSettings.DeleteValue("id");

            // Verify the deletion.
            Console.WriteLine((string)testSettings.GetValue(
                "id", "ID not found."));
        }

        // Delete or close the new subkey.
        Console.Write("\nDelete newly created registry key? (Y/N) ");
        if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
        {
            Registry.CurrentUser.DeleteSubKeyTree("Test9999");
            Console.WriteLine("\nRegistry key {0} deleted.",
                test9999.Name);
        }
        else
        {
            Console.WriteLine("\nRegistry key {0} closed.",
                test9999.ToString());
            test9999.Close();
        }
    }
}
Imports System.Security.Permissions
Imports Microsoft.Win32

Public Class RegKey
    Shared Sub Main()

        ' Create a subkey named Test9999 under HKEY_CURRENT_USER.
        Dim test9999 As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("Test9999")

        ' Create two subkeys under HKEY_CURRENT_USER\Test9999.
        test9999.CreateSubKey("TestName").Close()
        Dim testSettings As RegistryKey = _
            test9999.CreateSubKey("TestSettings")

        ' Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French")
        testSettings.SetValue("Level", "Intermediate")
        testSettings.SetValue("ID", 123)
        testSettings.Close()

        ' Print the information from the Test9999 subkey.
        Console.WriteLine("There are {0} subkeys under Test9999.", _
            test9999.SubKeyCount.ToString())
        For Each subKeyName As String In test9999.GetSubKeyNames()
            Dim tempKey As RegistryKey = _
                test9999.OpenSubKey(subKeyName)
            Console.WriteLine(vbCrLf & "There are {0} values for " & _
                "{1}.", tempKey.ValueCount.ToString(), tempKey.Name)
            For Each valueName As String In tempKey.GetValueNames()
                Console.WriteLine("{0,-8}: {1}", valueName, _
                    tempKey.GetValue(valueName).ToString())
            Next
        Next

        ' Delete the ID value.
        testSettings = test9999.OpenSubKey("TestSettings", True)
        testSettings.DeleteValue("id")

        ' Verify the deletion.
        Console.WriteLine(CType(testSettings.GetValue( _
            "id", "ID not found."), String))
        testSettings.Close()

        ' Delete or close the new subkey.
        Console.Write(vbCrLf & "Delete newly created " & _
            "registry key? (Y/N) ")
        If Char.ToUpper(Convert.ToChar(Console.Read())) = "Y"C Then
            Registry.CurrentUser.DeleteSubKeyTree("Test9999")
            Console.WriteLine(vbCrLf & "Registry key {0} deleted.", _
                test9999.Name)
        Else
            Console.WriteLine(vbCrLf & "Registry key {0} closed.", _
                test9999.ToString())
            test9999.Close()
        End If
   
    End Sub
End Class

Poznámky

K provedení této akce musí mít uživatel v hierarchii registru oprávnění na této a nižší úrovni.

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Viz také

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck)

Zdroj:
RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis pomocí zadané možnosti kontroly oprávnění.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

permissionCheck
RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Atributy

Výjimky

subkey je null.

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

permissionCheck obsahuje neplatnou hodnotu.

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

Do objektu RegistryKey nelze zapisovat. Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

K provedení této akce musí mít uživatel v hierarchii registru oprávnění na této a nižší úrovni.

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Chcete-li použít metodu OpenSubKey , musíte mít instanci RegistryKey třídy . Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Viz také

Platí pro

CreateSubKey(String, Boolean)

Zdroj:
RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable);
member this.CreateSubKey : string * bool -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, writable As Boolean) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

writable
Boolean

trueoznačující, že nový podklíč je zapisovatelný; v opačném případě . false

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Atributy

Výjimky

subkey je null.

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

Aktuální RegistryKey soubor nelze zapsat do . Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

K provedení této akce musí mít uživatel v hierarchii registru oprávnění na této a nižší úrovni.

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Chcete-li použít metodu CreateSubKey , musíte mít instanci RegistryKey třídy . Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Zdroj:
RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění a zabezpečení registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity? registrySecurity);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registrySecurity As RegistrySecurity) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

permissionCheck
RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

registrySecurity
RegistrySecurity

Zabezpečení řízení přístupu pro nový klíč.

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Atributy

Výjimky

subkey je null.

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

permissionCheck obsahuje neplatnou hodnotu.

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

Aktuální RegistryKey soubor nelze zapsat do . Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Metoda CreateSubKey vytvoří klíč registru, který má řízení přístupu určené parametrem registrySecurity . Vrácený RegistryKey objekt představuje klíč registru, ale tento objekt není omezen řízením přístupu zadaným v parametru registrySecurity .

Pokud permissionCheck je RegistryKeyPermissionCheck.ReadWriteSubTree, klíč se otevře pro přístup pro čtení i zápis. Pokud permissionCheck je RegistryKeyPermissionCheck.ReadSubTree, klíč se otevře pro přístup pro čtení.

Z důvodu zpětné kompatibility je klíč otevřen pro čtení a zápis, pokud permissionCheck je RegistryKeyPermissionCheck.Default , a nadřazený klíč má RegistryKeyPermissionCheck.Defaulttaké . Pokud má nadřazený klíč jiné nastavení, stav čtení a zápisu se řídí nastavením nadřazeného klíče.

Aby uživatel mohl tuto akci provést, musí mít v hierarchii registru oprávnění na této a nižší úrovni.

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Chcete-li použít metodu OpenSubKey , musíte mít instanci RegistryKey třídy. Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy.

Viz také

Platí pro

CreateSubKey(String, Boolean, RegistryOptions)

Zdroj:
RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od verze .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable, Microsoft::Win32::RegistryOptions options);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable, Microsoft.Win32.RegistryOptions options);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, bool writable, Microsoft.Win32.RegistryOptions options);
member this.CreateSubKey : string * bool * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, writable As Boolean, options As RegistryOptions) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

writable
Boolean

trueoznačující, že nový podklíč je zapisovatelný; v opačném případě . false

options
RegistryOptions

Možnost registru, která se má použít.

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Atributy

Výjimky

subkey je null.

options nezadá platnou možnost.

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

Aktuální RegistryKey soubor nelze zapsat do, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například odstranění klíče nebo pokusu o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Aby uživatel mohl tuto akci provést, musí mít v hierarchii registru oprávnění na této a nižší úrovni.

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce bezvýznamných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Chcete-li použít metodu CreateSubKey , musíte mít instanci RegistryKey třídy. Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy.

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Zdroj:
RegistryKey.cs

Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané kontroly oprávnění a možností registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions);
public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions options);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions options);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions) As RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, options As RegistryOptions) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen.

permissionCheck
RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

registryOptionsoptions
RegistryOptions

Možnost registru, která se má použít; například vytvoří nestálý klíč.

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala.

Atributy

Výjimky

subkey je null.

Aktuální RegistryKey objekt je zavřený (nelze získat přístup k uzavřeným klíčům).

Aktuální RegistryKey objekt nelze zapsat do. Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá požadovaná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

Poznámky

Pokud chcete získat aktuální RegistryKey objekt, zadejte prázdný řetězec ("") pro subkey.

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Zdroj:
RegistryKey.cs

Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění, možnosti registru a zabezpečení registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity? registrySecurity);
[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey (string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey
Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions, registrySecurity As RegistrySecurity) As RegistryKey

Parametry

subkey
String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen.

permissionCheck
RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

registryOptions
RegistryOptions

Možnost registru, která se má použít.

registrySecurity
RegistrySecurity

Zabezpečení řízení přístupu pro nový podklíč

Návraty

Nově vytvořený podklíč nebo null pokud operace selhala.

Atributy

Výjimky

subkey je null.

Aktuální RegistryKey objekt je zavřený. K uzavřeným klíčům nelze získat přístup.

Aktuální RegistryKey objekt nelze zapsat do. Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá požadovaná přístupová práva.

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Uživatel nemá oprávnění nutná k vytvoření nebo otevření klíče registru.

Poznámky

Pokud chcete získat aktuální RegistryKey objekt, zadejte prázdný řetězec ("") pro subkey.

Platí pro