REG_UNLOAD_KEY_INFORMATION-Struktur (wdm.h)

  • Artikel

Die REG_UNLOAD_KEY_INFORMATION-Struktur enthält Informationen, die die RegistryCallback-Routine eines Treibers verwenden kann, wenn eine Registrierungsstruktur entladen wird.

Syntax

typedef struct _REG_UNLOAD_KEY_INFORMATION {
  PVOID Object;
  PVOID UserEvent;
  PVOID CallContext;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;

Member

Object

Ein Zeiger auf ein Registrierungsschlüsselobjekt. Dieses Objekt stellt den Stammschlüssel der Struktur dar, die entladen wird.

UserEvent

Ein Zeiger auf ein Ereignisobjekt.

CallContext

Optionale vom Treiber definierte Kontextinformationen, die die RegistryCallback-Routine des Treibers bereitstellen kann. Dieser Member wird ab Windows Vista definiert.

ObjectContext

Ein Zeiger auf vom Treiber definierte Kontextinformationen, die der Treiber durch Aufrufen von CmSetCallbackObjectContext einem Registrierungsobjekt zugeordnet hat. Dieser Member wird ab Windows Vista definiert.

Reserved

Dieses Element ist für die zukünftige Verwendung reserviert. Dieser Member wird ab Windows Vista definiert.

Hinweise

Diese Struktur wird von der RegistryCallback-Routine verwendet. Wenn der Argument1-Parameter für die RegistryCallback-RoutineRegNtPreUnloadKey ist, ist der Argument2-Parameter ein Zeiger auf eine REG_UNLOAD_KEY_INFORMATION-Struktur .

Das Betriebssystem übergibt die REG_UNLOAD_KEY_INFORMATION-Struktur an die RegistryCallback-Routine , wenn ein Thread versucht, einen Schlüssel zu entladen, z. B. wenn ein Benutzermodusthread die RegUnloadKey-Funktion aufruft . Als Reaktion auf eine RegNtPreUnloadKey-Benachrichtigung sollte die RegistryCallback-Routine alle Ressourcen freigeben, die der Treiber zuvor für die Verwendung mit der Struktur zugewiesen hat, bevor die Struktur entladen wird.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

CmSetCallbackObjectContext

RegistryCallback