RegReplaceKey函数用另一个文件替换支持一个密钥及其所有子密钥的文件,这样当系统下次启动时,密钥和子密钥将具有存储在新文件中的值。
LONG RegReplaceKey(
HKEY 【的hKeyru-Latn】, | //打开密钥的句柄 |
LPCTSTR 【lpSubKey】, | //子地址名称 |
LPCTSTR 【lpNewFile】, | //具有新数据的文件的文件名的地址 |
LPCTSTR 【lpOldFile】 | //备份文件的文件名的地址 |
); |
参数
【的hKeyru-Latn】
标识当前打开的键或任何以下预定义保留句柄值:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
【lpSubKey】
指向一个以null结尾的字符串,其中包含其子项和值由此函数替换的键的名称。该密钥必须是由【的hKeyru-Latn】参数标识的密钥的子密钥。此参数可以为NULL。
选择的键必须是蜂巢的根;也就是说,它必须是HKEY_LOCAL_MACHINE或HKEY_USERS的即时后代。
【lpNewFile】
指向一个以null结尾的字符串,其中包含具有注册信息的文件的名称。该文件通常使用RegSaveKey功能创建。在文件分配表(FAT)文件系统下,文件名可能没有扩展名。
【lpOldFile】
指向一个以null结尾的字符串,其中包含接收要替换的注册表信息的备份副本的文件的名称。如果此文件是在FAT文件系统下创建的,则不应该有扩展名。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的一般描述。
备注
由【lpNewFile】参数指定的文件保持打开,直到系统重新启动。
如果【的hKeyru-Latn】是由RegConnectRegistry返回的句柄,则【lpNewFile】和【lpOldFile】中指定的路径与远程计算机相关。
Windows NT:呼叫进程必须具有SE_RESTORE_NAME特权。有关权限的详细信息,请参阅特权.
Windows 95:不支持或不需要安全权限。
也可以看看