RegRestoreKeyA 函数 (winreg.h)
读取指定文件中的注册表信息，并将其复制到指定的键上。 此注册表信息可能采用一个键和多个级别的子项的形式。
备份或还原系统状态（包括系统文件和注册表配置单元）的应用程序应使用 卷影复制服务 ，而不是注册表功能。
语法
LSTATUS RegRestoreKeyA(
[in] HKEY hKey,
[in] LPCSTR lpFile,
[in] DWORD dwFlags
);
参数
[in] hKey
打开的注册表项的句柄。 此句柄由 RegCreateKeyEx 或 RegOpenKeyEx 函数返回。 也可以是以下 预定义键之一：
HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS 此键及其后代键中包含的任何信息都将被 lpFile 参数指向的文件中的信息覆盖。
[in] lpFile
包含注册表信息的文件的名称。 此文件通常是使用 RegSaveKey 函数创建的。
[in] dwFlags
指示如何还原密钥的标志。 此参数的取值可为下列值之一：
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用，以获取错误的泛型说明。
注解
有两种不同的注册表配置单元文件格式。 在当前操作系统上创建的注册表配置单元通常无法由早期操作系统加载。
如果 hKey 参数的任何子项处于打开状态， 则 RegRestoreKey 将失败。
调用进程必须在注册表所在的计算机上具有SE_RESTORE_NAME和SE_BACKUP_NAME特权。 有关详细信息，请参阅使用特殊特权运行。
此函数将指定键下面的键和值替换为文件中顶级键的辅助键和值，而不管文件中顶级键的名称是什么。 例如， hKey 可能标识具有子项 B 和 C 的键 A，而 lpFile 参数指定包含子项 Y 和 Z 的键 X 的文件。调用 RegRestoreKey 后，注册表将包含子项 Y 和 Z 的项 A。A 的值条目将替换为 X 的值条目。
lpFile 指定的文件中的新信息将覆盖 hKey 参数指定的密钥的内容，但密钥名称除外。
如果 hKey 表示远程计算机中的密钥，则 lpFile 描述的路径相对于远程计算机。
注意
winreg.h 标头将 RegRestoreKey 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winreg.h (包括 Windows.h) |
| Library | Advapi32.lib |
| DLL | Advapi32.dll |