RegistryKey.CreateSubKey 메서드

참조

정의

네임스페이스:: Microsoft.Win32

어셈블리:: Microsoft.Win32.Registry.dll

어셈블리:: mscorlib.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

새 하위 키를 만들거나 기존 하위 키를 엽니다.

오버로드

CreateSubKey(String)	새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.
CreateSubKey(String, RegistryKeyPermissionCheck)	지정된 권한 검사 옵션을 사용하여 새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.
CreateSubKey(String, Boolean)	새 하위 키를 만들거나 지정된 액세스로 기존 하위 키를 엽니다. .NET Framework 4.6부터 사용할 수 있습니다.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)	지정된 권한 검사 옵션과 레지스트리 보안을 사용하여 새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.
CreateSubKey(String, Boolean, RegistryOptions)	새 하위 키를 만들거나 지정된 액세스로 기존 하위 키를 엽니다. .NET Framework 4.6부터 사용할 수 있습니다.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)	지정된 권한 검사 및 레지스트리 옵션을 사용하여 하위 키를 만들거나 쓰기 권한을 위해 하위 키를 엽니다.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)	지정된 권한 검사 옵션, 레지스트리 옵션 및 레지스트리 보안을 사용하여 하위 키를 만들거나 쓰기 권한을 위해 하위 키를 엽니다.

CreateSubKey(String)

Source:: RegistryKey.cs

새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.

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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다. 길이가 0인 문자열이 subkey에 지정되어 있으면 현재 RegistryKey 개체가 반환됩니다.

예외

ArgumentNullException

subkey이(가) null인 경우

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

ObjectDisposedException

이 메서드를 호출할 RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

UnauthorizedAccessException

RegistryKey에 쓸 수 없는 경우. 예를 들어, 해당 키가 쓸 수 있는 키로 열리지 않았거나 사용자에게 필요한 액세스 권한이 없습니다.

IOException

중첩 수준이 510을 초과합니다.

또는

키 삭제와 같은 시스템 오류가 발생했거나 LocalMachine 루트에 키를 만들려고 했습니다.

예제

다음 코드 예제에서는 HKEY_CURRENT_USER 아래에 하위 키를 만들고 내용을 조작한 다음 하위 키를 삭제하는 방법을 보여 줍니다.

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

설명

이 작업을 수행하려면 사용자에게 레지스트리 계층 구조에서 이 수준 이하의 권한이 있어야 합니다.

주의

악의적인 프로그램이 수천 개의 의미 없는 하위 키 또는 키/값 쌍을 만들 수 있는 방식으로 개체를 노출 RegistryKey 하지 마세요. 예를 들어 호출자가 임의의 키 또는 값을 입력하도록 허용하지 않습니다.

추가 정보

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck)

Source:: RegistryKey.cs

지정된 권한 검사 옵션을 사용하여 새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.

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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

permissionCheck: RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다. 길이가 0인 문자열이 subkey에 지정되어 있으면 현재 RegistryKey 개체가 반환됩니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey이(가) null인 경우

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

ArgumentException

permissionCheck에 잘못된 값이 포함된 경우

ObjectDisposedException

이 메서드를 호출할 RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

UnauthorizedAccessException

RegistryKey에 쓸 수 없는 경우. 예를 들어, 해당 키가 쓸 수 있는 키로 열리지 않았거나 사용자에게 필요한 액세스 권한이 없습니다.

IOException

중첩 수준이 510을 초과합니다.

또는

키 삭제와 같은 시스템 오류가 발생했거나 LocalMachine 루트에 키를 만들려고 했습니다.

설명

이 작업을 수행하려면 사용자에게 레지스트리 계층 구조에서 이 수준 이하의 권한이 있어야 합니다.

주의

메서드를 OpenSubKey 사용하려면 클래스의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

적용 대상

CreateSubKey(String, Boolean)

Source:: RegistryKey.cs

새 하위 키를 만들거나 지정된 액세스로 기존 하위 키를 엽니다. .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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

writable: Boolean

새 하위 키를 쓸 수 있으면 true이고, 그렇지 않으면 false입니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다. 길이가 0인 문자열이 subkey에 지정되어 있으면 현재 RegistryKey 개체가 반환됩니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey이(가) null인 경우

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

UnauthorizedAccessException

현재 RegistryKey에 쓸 수 없습니다. 예를 들어 쓸 수 있는 키로 열지 않았거나 사용자에게 필요한 액세스 권한이 없습니다.

IOException

중첩 수준이 510을 초과합니다.

또는

키 삭제와 같은 시스템 오류가 발생했거나 LocalMachine 루트에 키를 만들려고 했습니다.

설명

이 작업을 수행하려면 사용자에게 레지스트리 계층 구조에서 이 수준 이하의 권한이 있어야 합니다.

주의

메서드를 CreateSubKey 사용하려면 클래스의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Source:: RegistryKey.cs

지정된 권한 검사 옵션과 레지스트리 보안을 사용하여 새 하위 키를 만들거나 쓰기 권한으로 기존 하위 키를 엽니다.

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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

permissionCheck: RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

registrySecurity: RegistrySecurity

새 키에 대한 액세스 제어 보안입니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다. 길이가 0인 문자열이 subkey에 지정되어 있으면 현재 RegistryKey 개체가 반환됩니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey이(가) null인 경우

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

ArgumentException

permissionCheck에 잘못된 값이 포함된 경우

ObjectDisposedException

이 메서드를 호출할 RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

UnauthorizedAccessException

현재 RegistryKey에 쓸 수 없습니다. 예를 들어 쓸 수 있는 키로 열지 않았거나 사용자에게 필요한 액세스 권한이 없습니다.

IOException

중첩 수준이 510을 초과합니다.

또는

키 삭제와 같은 시스템 오류가 발생했거나 LocalMachine 루트에 키를 만들려고 했습니다.

설명

메서드는 CreateSubKey 매개 변수로 지정된 registrySecurity 액세스 제어가 있는 레지스트리 키를 만듭니다. 반환되는 개체는 RegistryKey 레지스트리 키를 나타내지만 해당 개체는 매개 변수에 지정된 액세스 제어에 registrySecurity 의해 제한되지 않습니다.

가 이RegistryKeyPermissionCheck.ReadWriteSubTree면 permissionCheck 읽기/쓰기 액세스를 위해 키가 열립니다. 가 이RegistryKeyPermissionCheck.ReadSubTree면 permissionCheck 읽기 액세스를 위해 키가 열립니다.

이전 버전과의 호환성을 위해 가 이고 부모 키에도 이 있는 경우 permissionCheckRegistryKeyPermissionCheck.Default 읽기 및 쓰기를 위해 키가 RegistryKeyPermissionCheck.Default열립니다. 부모 키에 다른 설정이 있는 경우 읽기/쓰기 상태 부모 키의 설정에 의해 제어됩니다.

이 작업을 수행하려면 사용자에게 레지스트리 계층 구조에서 이 수준 이하의 권한이 있어야 합니다.

주의

메서드를 OpenSubKey 사용하려면 클래스의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

적용 대상

CreateSubKey(String, Boolean, RegistryOptions)

Source:: RegistryKey.cs

새 하위 키를 만들거나 지정된 액세스로 기존 하위 키를 엽니다. .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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다. 이 문자열은 대/소문자를 구분하지 않습니다.

writable: Boolean

새 하위 키를 쓸 수 있으면 true이고, 그렇지 않으면 false입니다.

options: RegistryOptions

사용할 레지스트리 옵션입니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다. 길이가 0인 문자열이 subkey에 지정되어 있으면 현재 RegistryKey 개체가 반환됩니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey은 null입니다.

ArgumentException

options 는 유효한 옵션을 지정하지 않습니다.

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

UnauthorizedAccessException

현재 RegistryKey에 쓸 수 없습니다. 예를 들어 쓸 수 있는 키로 열지 않았거나 사용자에게 필요한 액세스 권한이 없습니다.

IOException

중첩 수준이 510을 초과합니다.

또는

키 삭제와 같은 시스템 오류가 발생했거나 LocalMachine 루트에 키를 만들려고 했습니다.

설명

이 작업을 수행하려면 사용자에게 레지스트리 계층 구조에서 이 수준 이하의 권한이 있어야 합니다.

주의

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Source:: RegistryKey.cs

지정된 권한 검사 및 레지스트리 옵션을 사용하여 하위 키를 만들거나 쓰기 권한을 위해 하위 키를 엽니다.

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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다.

permissionCheck: RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

registryOptionsoptions: RegistryOptions

사용할 레지스트리 옵션입니다(예: 휘발성 키를 만드는 옵션).

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey이(가) null인 경우

ObjectDisposedException

현재 RegistryKey 개체를 닫습니다. 이때 닫힌 키는 액세스할 수 없습니다.

UnauthorizedAccessException

현재 RegistryKey 개체에 쓸 수 없는 경우. 예를 들어, 해당 키가 쓸 수 있는 키로 열리지 않았거나 사용자에게 필수 액세스 권한이 없는 경우.

IOException

중첩 수준이 510을 초과합니다.

또는

시스템 오류가 발생한 경우. 예를 들어, LocalMachine 루트에서 키를 삭제했거나 키를 만들려고 했습니다.

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

설명

현재 RegistryKey 개체를 가져오려면 에 빈 문자열("")을 지정합니다 subkey.

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Source:: RegistryKey.cs

지정된 권한 검사 옵션, 레지스트리 옵션 및 레지스트리 보안을 사용하여 하위 키를 만들거나 쓰기 권한을 위해 하위 키를 엽니다.

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

매개 변수

subkey: String

만들거나 열 하위 키의 이름 또는 경로입니다.

permissionCheck: RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

registryOptions: RegistryOptions

사용할 레지스트리 옵션입니다.

registrySecurity: RegistrySecurity

새 하위 키에 대한 액세스 제어 보안입니다.

반환

RegistryKey

새로 만든 하위 키 또는 작업이 실패한 경우 null입니다.

특성: ComVisibleAttribute

예외

ArgumentNullException

subkey이(가) null인 경우

ObjectDisposedException

현재 RegistryKey 개체를 닫습니다. 닫힌 키에 액세스할 수 없습니다.

UnauthorizedAccessException

현재 RegistryKey 개체에 쓸 수 없는 경우. 예를 들어, 해당 키가 쓸 수 있는 키로 열리지 않았거나 사용자에게 필수 액세스 권한이 없는 경우.

IOException

중첩 수준이 510을 초과합니다.

또는

시스템 오류가 발생한 경우. 예를 들어, LocalMachine 루트에서 키를 삭제했거나 키를 만들려고 했습니다.

SecurityException

사용자에게 레지스트리 키를 만들거나 열 수 있는 권한이 없습니다.

설명

현재 RegistryKey 개체를 가져오려면 에 빈 문자열("")을 지정합니다 subkey.

적용 대상

다음을 통해 공유

RegistryKey.CreateSubKey 메서드

정의

오버로드

CreateSubKey(String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck)

매개 변수

반환

예외

설명

추가 정보

적용 대상

CreateSubKey(String, Boolean)

매개 변수

반환

예외

설명

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

매개 변수

반환

예외

설명

추가 정보

적용 대상

CreateSubKey(String, Boolean, RegistryOptions)

매개 변수

반환

예외

설명

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

매개 변수

반환

예외

설명

적용 대상

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

매개 변수

반환

예외

설명

적용 대상

추가 리소스