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)

另请参阅

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

ZwCreateKey

ZwOpenKey

ZwSetValueKey