Share via

NtRenameKey 함수(winternl.h)

  • 아티클

[이 함수는 추가 공지 없이 Windows에서 변경되거나 제거될 수 있습니다. ]

지정된 레지스트리 키의 이름을 변경합니다.

구문

__kernel_entry NTSTATUS NtRenameKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING NewName
);

매개 변수

[in] KeyHandle

이름을 바꿀 키에 대한 핸들입니다. 핸들은 KEY_WRITE 액세스 권한으로 열어야 합니다.

[in] NewName

키의 새 이름인 UNICODE 문자열에 대한 포인터입니다.

반환 값

NTSTATUS 또는 오류 코드를 반환합니다. STATUS_ACCESS_DENIED 오류 코드는 호출자에게 지정된 레지스트리 키 또는 하위 키에 필요한 액세스 권한이 없음을 나타냅니다.

NTSTATUS 오류 코드의 양식과 중요성은 WDK에서 사용할 수 있는 Ntstatus.h 헤더 파일에 나열되며 WDK 설명서에 설명되어 있습니다.

설명

이 함수에는 연결된 헤더 파일이 없습니다. LoadLibrary 및 GetProcAddress 함수를 사용하여 Ntdll.dll 동적으로 연결할 수도 있습니다.

NtRenameKey 함수를 사용하여 전체 레지스트리 하위 트리의 이름을 바꿀 수 있습니다. 호출자는 지정된 키의 부모에 대한 KEY_CREATE_SUB_KEY 액세스 권한이 있어야 하며 이름이 바뀐 전체 하위 트리에 대한 DELETE 액세스 권한이 있어야 합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 winternl.h
라이브러리 ntdll.lib
DLL ntdll.dll

추가 정보

레지스트리 키 보안 및 액세스 권한