共用方式為


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 版本

規格需求

需求
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlZwPassive (wdm) ZwRegistryCreate (storport) 、 ZwRegistryCreate (storport) , ZwRegistryCreate (wdm) ZwRegistryOpen (storport) 、ZwRegistryOpen (storport) 、 ZwRegistryOpen (wdm)

另請參閱

使用 Nt 和 Zw 版本的原生系統服務例程

ZwCreateKey

ZwOpenKey

ZwSetValueKey