RegRenameKey 函数 (winreg.h)

更改指定注册表项的名称。

语法

LSTATUS RegRenameKey(
  HKEY    hKey,
  LPCWSTR lpSubKeyName,
  LPCWSTR lpNewKeyName
);

参数

hKey

要重命名的密钥的句柄。 必须使用KEY_WRITE访问权限打开句柄。 有关详细信息，请参阅 注册表项安全和访问权限。

此句柄由 RegCreateKeyEx 或 RegOpenKeyEx 函数返回，也可以是以下 预定义键之一：

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

lpSubKeyName

要重命名的子项的名称。 此键必须是 由 hKey 参数标识的项的子项。 此参数也可以为 NULL，在这种情况下，由 hKey 参数标识的键将重命名。

lpNewKeyName

密钥的新名称。 新名称不得已存在。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志结合使用来获取错误的常规说明。 STATUS_ACCESS_DENIED错误代码指示调用方对指定的注册表项或子项没有必要的访问权限。

注解

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

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	winreg.h (包括 Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll

另请参阅

RegCopyTree

注册表函数

注册表概述

SECURITY_ATTRIBUTES