REG_UNLOAD_KEY_INFORMATION-Struktur (wdm.h)
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) |