RegFlushKey函数将指定的打开密钥的所有属性写入注册表。
LONG RegFlushKey(
HKEY 【的hKeyru-Latn】 | //写入的键的句柄 |
); |
参数
【的hKeyru-Latn】
标识当前打开的键或任何以下预定义保留句柄值:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的一般描述。
备注
没有必要调用RegFlushKey来更改密钥。注册表使用其懒惰冲洗器将注册表更改刷新到磁盘。在系统关机时,注册表更改也会刷新到磁盘。
与RegCloseKey不同,RegFlushKey函数只有在所有数据都已写入注册表时才会返回。
RegFlushKey功能也可以写出部分或全部其他键。过度调用此函数可能会对应用程序的性能产生负面影响。
如果需要绝对确定注册表更改在磁盘上,应用程序应该只调用RegFlushKey.一般来说,RegFlushKey很少需要使用。
也可以看看