RegSaveKey函数将指定的键及其所有子项和值保存到新文件中。
LONG RegSaveKey(
HKEY 【的hKeyru-Latn】, | //保存开始的句柄处理 |
LPCTSTR 【lpFile】, | //要保存的文件名的地址 |
LPSECURITY_ATTRIBUTES 【lpSecurityAttributes】 | //安全结构的地址 |
); |
参数
【的hKeyru-Latn】
指定要开始保存操作的键的句柄或以下任何预定义保留句柄值:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
【lpFile】
指向一个以null结尾的字符串,其中包含保存指定键和子项的文件的名称。此文件不能存在。如果此文件名包含扩展名,则不能在RegLoadKey,RegReplaceKey或RegRestoreKey功能的文件分配表(FAT)文件系统上使用。
【lpSecurityAttributes】
Windows NT:指向SECURITY_ATTRIBUTES结构的指针,指定新文件的安全描述符。如果【lpSecurityAttributes】为NULL,则该文件将获取默认安全描述符。
Windows 95:此参数被忽略。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的通用描述。
备注
如果【的hKeyru-Latn】表示远程计算机上的密钥,则【lpFile】描述的路径与远程计算机相关。
RegSaveKey功能仅保存非易失性键。它不保存易失性密钥。一个关键是在其创作时变得非挥发性或非挥发性;见RegCreateKeyEx.
Windows NT:呼叫进程必须具有SE_BACKUP_NAME特权。有关权限的详细信息,请参阅特权.
Windows 95:不支持或不需要安全权限。
也可以看看
RegCreateKeyEx, RegDeleteKey, RegLoadKey, RegReplaceKey, RegRestoreKey, SECURITY_ATTRIBUTES