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)

Weitere Informationen

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateKey

ZwOpenKey

ZwSetValueKey