ZwFlushKey 函数 (wdm.h)

ZwFlushKey 例程强制将注册表项提交到磁盘。

语法

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

参数

[in] KeyHandle

要刷新到磁盘的注册表项的句柄。 此句柄是通过成功调用 ZwCreateKeyZwOpenKey 创建的。

返回值

如果密钥信息已传输到磁盘,ZwFlushKey 将返回STATUS_SUCCESS,或者在失败时返回相应的错误代码。

注解

可以通过调用 ZwFlushKey 刷新 ZwCreateKeyZwSetValueKey 所做的更改。 此例程在将与 KeyHandle 关联的所有已更改数据写入磁盘后才会返回。 ZwFlushKey 刷新密钥的整个注册表配置单元,其中包括指定项的每个子项。

此例程可以刷新整个注册表。 因此,它可以生成大量 I/O。 由于系统每隔几秒钟自动刷新密钥更改,你很少需要调用 ZwFlushKey

有关使用注册表项的详细信息,请参阅 在驱动程序中使用注册表

如果在用户模式下调用此函数,则应使用名称“NtFlushKey”而不是“ZwFlushKey”。

对于来自内核模式驱动程序的调用,Windows 本机系统服务例程的 NtXxxZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxxZwXxx 版本之间的关系的详细信息,请参阅 使用本机系统服务例程的 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)

另请参阅

使用本机系统服务例程的 Nt 和 Zw 版本

ZwCreateKey

ZwOpenKey

ZwSetValueKey