REG_LOAD_KEY_INFORMATION-Struktur (wdm.h)

Artikel
02/27/2024

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

Syntax

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;

Member

Object

Ein Zeiger auf das Registrierungsschlüsselobjekt für den Stammschlüssel der Struktur, die 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

Ist für das System reserviert.

TrustClassObject

Ist für das System reserviert.

UserEvent

Ein Zeiger auf ein Ereignisobjekt, das beim Entladen der Struktur signalisiert wird.

DesiredAccess

Die Zugriffsmaske, die von dem 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 einen Speicherort, der das Handle zum Stamm der geladenen Struktur empfängt. Dieser Member kann nicht NULL sein, wenn eine Anwendungsstruktur geladen wird. In allen anderen Fällen sollte dieser Member NULL sein.

CallContext

Optionale vom Treiber definierte Kontextinformationen, die die RegistryCallback-Routine des Treibers bereitstellen kann.

ObjectContext

Ein Zeiger auf vom Treiber definierte Kontextinformationen, die der Treiber durch Aufrufen der CmSetCallbackObjectContext-Routine einem Registrierungsobjekt zugeordnet hat.

Reserved

Ist für das System reserviert.

Hinweise

Jedes Mal, wenn ein Benutzermodusthread regLoadKey aufruft, um eine Registrierungsstruktur zu laden, übergibt das Betriebssystem die REG_LOAD_KEY_INFORMATION-Struktur an eine RegistryCallback-Routine.

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