structure REG_LOAD_KEY_INFORMATION (wdm.h)

Article
02/07/2025

La structure REG_LOAD_KEY_INFORMATION contient des informations sur une ruche de Registre chargée.

Syntaxe

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;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé racine de la ruche sur le point d’être chargé.

KeyName

Pointeur vers une structure UNICODE_STRING qui contient le nom de la clé racine.

SourceFile

Pointeur vers une structure UNICODE_STRING qui contient le nom du chemin d’accès d’un fichier qui contient les informations hive du Registre chargées.

Flags

Réservé à l’utilisation du système.

TrustClassObject

Réservé à l’utilisation du système.

UserEvent

Pointeur vers un objet d’événement signalé lorsque la ruche est déchargée.

DesiredAccess

Masque d’accès spécifié par le thread qui tente de charger la clé de Registre. Pour plus d’informations sur ce masque d’accès, consultez la description du paramètre desiredAccess de la routine ZwCreateKey.

RootHandle

Pointeur facultatif vers un emplacement qui reçoit le handle à la racine de la ruche chargée. Ce membre peut êtrenull si une ruche d’application est chargée. Dans tous les autres cas, ce membre doit être NULL .

CallContext

Informations contextuelles facultatives définies par le pilote que la routine RegistryCallback du pilote peut fournir.

ObjectContext

Pointeur vers les informations de contexte définies par le pilote associées à un objet de Registre en appelant la routine CmSetCallbackObjectContext.

Reserved

Réservé à l’utilisation du système.

Remarques

Le système d’exploitation transmet la structure REG_LOAD_KEY_INFORMATION à une routine de RegistryCallback chaque fois qu’un thread en mode utilisateur appelle RegLoadKey pour charger une ruche de Registre.

Pour plus d’informations sur les opérations de filtrage du Registre, consultez appels de Registre de filtrage.