structure REG_LOAD_KEY_INFORMATION (wdm.h)

Article
02/27/2024

La structure REG_LOAD_KEY_INFORMATION contient des informations sur une ruche de Registre en cours de chargement.

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ée.

KeyName

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

SourceFile

Pointeur vers une structure de UNICODE_STRING qui contient le nom de chemin d’accès d’un fichier qui contient les informations de ruche du Registre en cours de chargement.

Flags

Réservé pour le système.

TrustClassObject

Réservé pour le système.

UserEvent

Pointeur vers un objet d’événement qui est 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 vers la racine de la ruche en cours de chargement. Ce membre peut être non NULL si une ruche d’application est en cours de chargement. Dans tous les autres cas, ce membre doit avoir la valeur NULL.

CallContext

Informations de contexte 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 que le pilote a associées à un objet de Registre en appelant la routine CmSetCallbackObjectContext .

Reserved

Réservé pour le système.

Remarques

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

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