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) |