Funzione ZwFlushKey (wdm.h)

La routine ZwFlushKey forza il commit di una chiave del Registro di sistema su disco.

Sintassi

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Parametri

[in] KeyHandle

Gestire la chiave del Registro di sistema da scaricare su disco. Questo handle viene creato da una chiamata riuscita a ZwCreateKey o ZwOpenKey.

Valore restituito

ZwFlushKey restituisce STATUS_SUCCESS se le informazioni sulla chiave sono state trasferite sul disco o il codice di errore appropriato in caso di errore.

Commenti

È possibile scaricare le modifiche apportate da ZwCreateKey o ZwSetValueKey chiamando ZwFlushKey. Questa routine non restituisce finché non vengono scritti su disco tutti i dati modificati associati a KeyHandle . ZwFlushKey scarica l'intero hive del Registro di sistema per la chiave, che include ogni sottochiave della chiave specificata.

Questa routine può scaricare l'intero registro. Di conseguenza, può generare una grande quantità di I/O. Poiché il sistema scarica automaticamente la chiave ogni pochi secondi, raramente è necessario chiamare ZwFlushKey.

Per altre informazioni sull'uso delle chiavi del Registro di sistema, vedere Uso del Registro di sistema in un driver.

Se la chiamata a questa funzione si verifica in modalità utente, è necessario usare il nome "NtFlushKey" anziché "ZwFlushKey".

Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Vedi anche

Uso delle versioni Nt e Zw delle routine native di Servizi di sistema

ZwCreateKey

ZwOpenKey

ZwSetValueKey