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 |
Library | ntdll.lib |
DLL | ntdll.dll |