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 |