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

規格需求

需求 值
目標平台 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