Función ZwFlushKey (wdm.h)

La rutina ZwFlushKey obliga a que se confirme una clave del Registro en el disco.

Sintaxis

NTSYSAPI NTSTATUS ZwFlushKey(
  [in] HANDLE KeyHandle
);

Parámetros

[in] KeyHandle

Identificador de la clave del Registro que se va a vaciar en el disco. Este identificador se crea mediante una llamada correcta a ZwCreateKey o ZwOpenKey.

Valor devuelto

ZwFlushKey devuelve STATUS_SUCCESS si la información de clave se transfirió al disco o el código de error adecuado en caso de error.

Comentarios

Puede vaciar los cambios realizados por ZwCreateKey o ZwSetValueKey llamando a ZwFlushKey. Esta rutina no devuelve hasta que todos los datos modificados asociados a KeyHandle se han escrito en el disco. ZwFlushKey vacía todo el subárbol del Registro para la clave, que incluye cada subclave de la clave especificada.

Esta rutina puede vaciar todo el registro. En consecuencia, puede generar una gran cantidad de E/S. Dado que el sistema vacía los cambios de clave automáticamente cada pocos segundos, rara vez tiene que llamar a ZwFlushKey.

Para obtener más información sobre cómo trabajar con claves del Registro, consulte Uso del Registro en un controlador.

Si la llamada a esta función se produce en modo de usuario, debe usar el nombre "NtFlushKey" en lugar de "ZwFlushKey".

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDDIs(storport), IrqlZwPassive(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Consulte también

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwCreateKey

ZwOpenKey

ZwSetValueKey