RegRestoreKey

【勇芳软件工作室】汉化HomePreviousNext

RegRestoreKey函数读取指定文件中的注册表信息,并将其复制到指定的键上。该注册表信息可以是密钥和多级子密钥的形式。

LONG RegRestoreKey(

HKEY 【的hKeyru-Latn】,//恢复开始的键的句柄
LPCTSTR 【lpFile】,//包含已保存树的文件名的地址
DWORD 【dwFlags中】//可选标志
); 

参数

【的hKeyru-Latn】

标识当前打开的键或任何以下预定义保留句柄值:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

该密钥及其后代密钥中包含的任何信息将被【lpFile】参数指向的文件中的信息覆盖。

【lpFile】

指向一个以null结尾的字符串,其中包含具有注册表信息的文件的名称。此文件通常使用RegSaveKey功能创建。在文件分配表(FAT)文件系统下,文件名可能没有扩展名。

【dwFlags中】

指定一个标志,指示该键是否为volatile。(易失性密钥只有在下一次系统启动时才有效。)此参数是可选的;如果没有指定值,则该键不会变化。

该参数可以设置为REG_WHOLE_HIVE_VOLATILE标志。此标志不会恢复给定的键,而是导致创建一个新的,易失性的(仅内存)注册表信息。(蜂巢是一组大量的注册表信息,通常包含系统部分的所有相关信息。例如,HKEY_LOCAL_MACHINE \\ 硬件是一个不稳定的配置单元。)

如果指定了REG_WHOLE_HIVE_VOLATILE,则由【的hKeyru-Latn】参数标识的密钥必须是HKEY_USERSHKEY_LOCAL_MACHINE值。

返回值

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

如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的一般描述。

备注

如果【的hKeyru-Latn】参数的任何子项已打开,则RegRestoreKey将失败。如果呼叫进程没有SE_RESTORE_NAME特权,该函数也将失败。有关权限的更多信息,请参阅特权.

此函数可以将键和值替换为文件中顶级键附属的键和值,而不管文件中顶级键的名称如何。例如,【的hKeyru-Latn】可以使用子密钥BC标识密钥A,而【lpFile】参数指定包含密钥X的文件,具有子密钥YZ.调用RegRestoreKey后,注册表中将包含密钥A,其中包含子密钥YZ.A的值条目将被X的值条目替换。

【lpFile】指定的文件中的新信息将覆盖由【的hKeyru-Latn】参数指定的键的内容,键名除外。

如果【的hKeyru-Latn】表示远程计算机中的密钥,【lpFile】描述的路径是相对于远程计算机。

也可以看看

RegDeleteKey, RegLoadKey, RegReplaceKey, RegSaveKey