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 访问权限。