ZwFlushKey-Funktion (wdm.h)
Die ZwFlushKey-Routine erzwingt, dass ein Registrierungsschlüssel auf den Datenträger committet wird.
Syntax
NTSYSAPI NTSTATUS ZwFlushKey(
[in] HANDLE KeyHandle
);
Parameter
[in] KeyHandle
Handle für den Registrierungsschlüssel, der auf den Datenträger geleert werden soll. Dieses Handle wird durch einen erfolgreichen Aufruf von ZwCreateKey oder ZwOpenKey erstellt.
Rückgabewert
ZwFlushKey gibt STATUS_SUCCESS zurück, wenn die Schlüsselinformationen auf den Datenträger übertragen wurden, oder den entsprechenden Fehlercode bei Einem Fehler.
Hinweise
Sie können änderungen, die von ZwCreateKey oder ZwSetValueKey vorgenommen wurden, löschen, indem Sie ZwFlushKey aufrufen. Diese Routine wird erst zurückgegeben, wenn alle geänderten Daten, die KeyHandle zugeordnet sind, auf den Datenträger geschrieben wurden. ZwFlushKey leeren die gesamte Registrierungsstruktur für den Schlüssel, die jeden Unterschlüssel des angegebenen Schlüssels enthält.
Diese Routine kann die gesamte Registrierung leeren. Dementsprechend kann es viele E/A-Vorgänge generieren. Da das System Schlüsseländerungen automatisch alle paar Sekunden leert, müssen Sie selten ZwFlushKey aufrufen.
Weitere Informationen zum Arbeiten mit Registrierungsschlüsseln finden Sie unter Verwenden der Registrierung in einem Treiber.
Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtFlushKey" anstelle von "ZwFlushKey" verwenden.
Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm) |