REG_LOAD_KEY_INFORMATION Struktur (wdm.h)

Artikel
07.02.2025

Die REG_LOAD_KEY_INFORMATION-Struktur enthält Informationen zu einer Registrierungsstruktur, die geladen wird.

Syntax

C++

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;

Angehörige

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den Stammschlüssel der Struktur, die gerade geladen werden soll.

KeyName

Ein Zeiger auf eine UNICODE_STRING Struktur, die den Namen des Stammschlüssels enthält.

SourceFile

Ein Zeiger auf eine UNICODE_STRING-Struktur, die den Pfadnamen einer Datei enthält, die die Registrierungsstrukturinformationen enthält, die geladen werden.

Flags

Reserviert für die Systemverwendung.

TrustClassObject

Reserviert für die Systemverwendung.

UserEvent

Ein Zeiger auf ein Ereignisobjekt, das signalisiert wird, wenn die Struktur entladen wird.

DesiredAccess

Die Zugriffsmaske, die vom Thread angegeben wurde, der versucht, den Registrierungsschlüssel zu laden. Weitere Informationen zu dieser Zugriffsmaske finden Sie in der Beschreibung des DesiredAccess- Parameters der ZwCreateKey Routine.

RootHandle

Ein optionaler Zeiger auf eine Position, die das Handle an den Stamm der struktur empfängt, die geladen wird. Dieses Element kann nichtNULL- sein, wenn eine Anwendungsstruktur geladen wird. In allen anderen Fällen sollte dieses Element NULL-sein.

CallContext

Optionale treiberdefinierte Kontextinformationen, die die RegistryCallback Routine des Treibers bereitstellen können.

ObjectContext

Ein Zeiger auf treiberdefinierte Kontextinformationen, die der Treiber einem Registrierungsobjekt zugeordnet hat, indem er die CmSetCallbackObjectContext Routine aufruft.

Reserved

Reserviert für die Systemverwendung.

Bemerkungen

Das Betriebssystem übergibt die REG_LOAD_KEY_INFORMATION Struktur bei jedem Aufruf RegLoadKey- an eine RegistryCallback Routine, wenn ein Benutzermodusthread aufruft RegLoadKey, um eine Registrierungsstruktur zu laden.

Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.