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 |