estructura REG_LOAD_KEY_INFORMATION (wdm.h)

Artículo
02/27/2024

La estructura REG_LOAD_KEY_INFORMATION contiene información sobre un subárbol del Registro que se está cargando.

Sintaxis

typedef struct _REG_LOAD_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING KeyName;
  PUNICODE_STRING SourceFile;
  ULONG           Flags;
  PVOID           TrustClassObject;
  PVOID           UserEvent;
  ACCESS_MASK     DesiredAccess;
  PHANDLE         RootHandle;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_LOAD_KEY_INFORMATION, *PREG_LOAD_KEY_INFORMATION;

Miembros

Object

Puntero al objeto de clave del Registro para la clave raíz del subárbol que está a punto de cargarse.

KeyName

Puntero a una estructura de UNICODE_STRING que contiene el nombre de la clave raíz.

SourceFile

Puntero a una estructura de UNICODE_STRING que contiene el nombre de ruta de acceso de un archivo que contiene la información del subárbol del Registro que se está cargando.

Flags

Reservado para uso del sistema.

TrustClassObject

Reservado para uso del sistema.

UserEvent

Puntero a un objeto de evento que se señala cuando se descarga el subárbol.

DesiredAccess

Máscara de acceso especificada por el subproceso que intenta cargar la clave del Registro. Para obtener más información sobre esta máscara de acceso, vea la descripción del parámetro DesiredAccess de la rutina ZwCreateKey .

RootHandle

Puntero opcional a una ubicación que recibe el identificador de la raíz del subárbol que se está cargando. Este miembro puede ser distinto de NULL si se carga un subárbol de la aplicación. En todos los demás casos, este miembro debe ser NULL.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina RegistryCallback del controlador.

ObjectContext

Puntero a la información de contexto definida por el controlador que el controlador ha asociado a un objeto del Registro llamando a la rutina CmSetCallbackObjectContext .

Reserved

Reservado para uso del sistema.

Comentarios

El sistema operativo pasa la estructura REG_LOAD_KEY_INFORMATION a una rutina RegistryCallback cada vez que un subproceso en modo de usuario llama a RegLoadKey para cargar un subárbol del Registro.

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