REG_RESTORE_KEY_INFORMATION Struktur (wdm.h)
Die REG_RESTORE_KEY_INFORMATION Struktur enthält die Informationen für einen Registrierungsschlüssel, der wiederhergestellt werden soll.
Syntax
typedef struct _REG_RESTORE_KEY_INFORMATION {
PVOID Object;
HANDLE FileHandle;
ULONG Flags;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_RESTORE_KEY_INFORMATION, *PREG_RESTORE_KEY_INFORMATION;
Angehörige
Object
Ein Zeiger auf ein Registrierungsschlüsselobjekt für den Schlüssel, der gerade wiederhergestellt werden soll.
FileHandle
Ein Handle für die Datei, aus der die Struktur wiederhergestellt wird.
Flags
REG_FORCE_RESTORE
0x00000008L
Wenn angegeben, wird der Wiederherstellungsvorgang auch dann ausgeführt, wenn geöffnete Handles an oder unter dem Speicherort in der Registrierungshierarchie vorhanden sind, auf den der hKey Parameter verweist.
REG_WHOLE_HIVE_VOLATILE
0x00000001L
Wenn angegeben, wird eine neue, veränderliche (nur speichergeschützte) Gruppe von Registrierungsinformationen oder Strukturerstellt. Wenn REG_WHOLE_HIVE_VOLATILE angegeben ist, muss der durch den hKey- Parameter identifizierte Schlüssel entweder der HKEY_USERS- oder HKEY_LOCAL_MACHINE wert sein.
REG_REFRESH_HIVE
0x00000002
Wenn festgelegt, wird die Position der Unterstruktur, auf die der hKey Parameter verweist, unmittelbar nach dem letzten Leeren wiederhergestellt. Die Unterstruktur darf nicht faul geleert werden (durch Aufrufen von RegRestoreKey mit REG_NO_LAZY_FLUSH als Wert dieses Parameters angegeben); der Aufrufer muss über die vertrauenswürdige Computerbasis (TCB)-Berechtigung verfügen; und das Handle, auf das sich der hKey-Parameter bezieht, muss auf den Stamm der Unterstruktur verweisen.
CallContext
Optionale treiberdefinierte Kontextinformationen, die die RegistryCallback Routine des Treibers bereitstellen können. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
ObjectContext
Ein Zeiger auf treiberdefinierte Kontextinformationen, die der Treiber einem Registrierungsobjekt zugeordnet hat, indem CmSetCallbackObjectContextaufgerufen wird. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Reserved
Dieses Mitglied ist für die zukünftige Verwendung reserviert. Dieses Element ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.
Bemerkungen
Das REG_REFRESH_HIVE Flag ist undurchsichtig, und ein Filter sollte nicht versuchen, es zu ändern.
Weitere Informationen zu Registrierungsfiltervorgängen finden Sie unter Filtern von Registrierungsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar unter Windows Vista SP2 und höheren Versionen des Windows-Betriebssystems. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |