REG_UNLOAD_KEY_INFORMATION Struktur (wdm.h)
Die REG_UNLOAD_KEY_INFORMATION-Struktur enthält Informationen, die ein Treiber RegistryCallback Routine 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;
Angehörige
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 treiberdefinierte Kontextinformationen, die die RegistryCallback Routine des Treibers bereitstellen können. Dieses Element wird ab Windows Vista definiert.
ObjectContext
Ein Zeiger auf treiberdefinierte Kontextinformationen, die der Treiber einem Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContextaufgerufen wird. Dieses Element wird ab Windows Vista definiert.
Reserved
Dieses Mitglied ist für die zukünftige Verwendung reserviert. Dieses Element wird ab Windows Vista definiert.
Bemerkungen
Diese Struktur wird von der RegistryCallback Routine verwendet. Wenn der parameter Argument1 der RegistryCallback Routine RegNtPreUnloadKeyist, ist der Argument2 Parameter ein Zeiger auf eine REG_UNLOAD_KEY_INFORMATION Struktur.
Das Betriebssystem übergibt die REG_UNLOAD_KEY_INFORMATION Struktur jedes Mal, wenn ein Thread versucht, einen Schlüssel zu entladen, an die RegistryCallback Routine, 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |