estructura REG_RESTORE_KEY_INFORMATION (wdm.h)

  • Artículo

La estructura REG_RESTORE_KEY_INFORMATION contiene la información de una clave del Registro que está a punto de restaurarse.

Sintaxis

typedef struct _REG_RESTORE_KEY_INFORMATION {
  PVOID  Object;
  HANDLE FileHandle;
  ULONG  Flags;
  PVOID  CallContext;
  PVOID  ObjectContext;
  PVOID  Reserved;
} REG_RESTORE_KEY_INFORMATION, *PREG_RESTORE_KEY_INFORMATION;

Miembros

Object

Puntero a un objeto de clave del Registro para la clave que está a punto de restaurarse.

FileHandle

Identificador del archivo desde el que se restaurará el subárbol.

Flags

REG_FORCE_RESTORE

0x00000008L

Si se especifica, la operación de restauración se ejecuta incluso si existen identificadores abiertos en la ubicación de la jerarquía del Registro a la que apunta el parámetro hKey .

REG_WHOLE_HIVE_VOLATILE

0x00000001L

Si se especifica, se crea un nuevo conjunto volátil (solo memoria) de información del Registro, o hive. Si se especifica REG_WHOLE_HIVE_VOLATILE, la clave identificada por el parámetro hKey debe ser el valor HKEY_USERS o HKEY_LOCAL_MACHINE.

REG_REFRESH_HIVE

0x00000002

Si se establece, la ubicación del subárbol al que apunta el parámetro hKey se restaura a su estado inmediatamente después del último vaciado. El subárbol no debe ser vaciado diferido (llamando a RegRestoreKey con REG_NO_LAZY_FLUSH especificado como el valor de este parámetro); el autor de la llamada debe tener el privilegio de la base informática de confianza (TCB); y el identificador al que hace referencia el parámetro hKey debe apuntar a la raíz del subárbol.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina RegistryCallback del controlador. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

ObjectContext

Puntero a la información de contexto definida por el controlador, que el controlador ha asociado a un objeto del Registro mediante una llamada a CmSetCallbackObjectContext. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

Reserved

Este miembro se reserva para uso futuro. Este miembro se define para Windows Vista y versiones posteriores del sistema operativo Windows.

Comentarios

La marca REG_REFRESH_HIVE es opaca y un filtro no debe intentar cambiarlo.

Para obtener más información sobre las operaciones de filtrado del Registro, consulte Filtrado de llamadas del Registro.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista SP2 y versiones posteriores del sistema operativo Windows.
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

CmSetCallbackObjectContext

RegistryCallback