struttura REG_LOAD_KEY_INFORMATION (wdm.h)

Articolo
02/07/2025

La struttura REG_LOAD_KEY_INFORMATION contiene informazioni su un hive del Registro di sistema caricato.

Sintassi

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;

Membri

Object

Puntatore all'oggetto chiave del Registro di sistema per la chiave radice dell'hive che sta per essere caricato.

KeyName

Puntatore a una struttura UNICODE_STRING che contiene il nome della chiave radice.

SourceFile

Puntatore a una struttura UNICODE_STRING che contiene il nome del percorso di un file che contiene le informazioni sull'hive del Registro di sistema da caricare.

Flags

Riservato per l'uso del sistema.

TrustClassObject

Riservato per l'uso del sistema.

UserEvent

Puntatore a un oggetto evento segnalato quando l'hive viene scaricato.

DesiredAccess

Maschera di accesso specificata dal thread che sta tentando di caricare la chiave del Registro di sistema. Per altre informazioni su questa maschera di accesso, vedere la descrizione del parametro DesiredAccess della routine ZwCreateKey.

RootHandle

Puntatore facoltativo a una posizione che riceve l'handle alla radice dell'hive da caricare. Questo membro può essere nonnull se viene caricato un hive dell'applicazione. In tutti gli altri casi, questo membro deve essere NULL.

CallContext

Informazioni di contesto facoltative definite dal driver che il driver RegistryCallback routine può fornire.

ObjectContext

Puntatore alle informazioni sul contesto definite dal driver associate a un oggetto del Registro di sistema chiamando la routine CmSetCallbackObjectContext.

Reserved

Riservato per l'uso del sistema.

Osservazioni

Il sistema operativo passa la struttura REG_LOAD_KEY_INFORMATION a una routine RegistryCallback ogni volta che un thread in modalità utente chiama RegLoadKey per caricare un hive del Registro di sistema.

Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.