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 文档中进行介绍。

注解

此函数没有关联的头文件。 还可以使用 LoadLibraryGetProcAddress 函数动态链接到 Ntdll.dll。

NtRenameKey 函数可用于重命名整个注册表子树。 调用方必须对指定键的父级具有 KEY_CREATE_SUB_KEY 访问权限,并且对要重命名的整个子树具有 DELETE 访问权限。

要求

   
目标平台 Windows
标头 winternl.h
Library ntdll.lib
DLL ntdll.dll

另请参阅

注册表项安全和访问权限