ZwFlushKey 函数 (wdm.h)
ZwFlushKey 例程强制将注册表项提交到磁盘。
语法
NTSYSAPI NTSTATUS ZwFlushKey(
[in] HANDLE KeyHandle
);
参数
[in] KeyHandle
要刷新到磁盘的注册表项的句柄。 此句柄是通过成功调用 ZwCreateKey 或 ZwOpenKey 创建的。
返回值
如果密钥信息已传输到磁盘,ZwFlushKey 将返回STATUS_SUCCESS,或者在失败时返回相应的错误代码。
注解
可以通过调用 ZwFlushKey 刷新 ZwCreateKey 或 ZwSetValueKey 所做的更改。 此例程在将与 KeyHandle 关联的所有已更改数据写入磁盘后才会返回。 ZwFlushKey 刷新密钥的整个注册表配置单元,其中包括指定项的每个子项。
此例程可以刷新整个注册表。 因此,它可以生成大量 I/O。 由于系统每隔几秒钟自动刷新密钥更改,你很少需要调用 ZwFlushKey。
有关使用注册表项的详细信息,请参阅 在驱动程序中使用注册表。
如果在用户模式下调用此函数,则应使用名称“NtFlushKey”而不是“ZwFlushKey”。
对于来自内核模式驱动程序的调用,Windows 本机系统服务例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息,请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
要求 | 值 |
---|---|
目标平台 | 通用 |
标头 | wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | HwStorPortProhibitedDDI (storport) 、 IrqlZwPassive (wdm) 、 ZwRegistryCreate (storport) 、ZwRegistryCreate (storport) , ZwRegistryCreate (wdm) 、 ZwRegistryOpen (storport) 、ZwRegistryOpen (storport) 、 ZwRegistryOpen (wdm) |