REG_RESTORE_KEY_INFORMATION-Struktur (wdm.h)

  • Artikel

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;

Member

Object

Ein Zeiger auf ein Registrierungsschlüsselobjekt für den Schlüssel, der 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 unterhalb des Speicherorts in der Registrierungshierarchie vorhanden sind, auf den der hKey-Parameter verweist.

REG_WHOLE_HIVE_VOLATILE

0x00000001L

Wenn angegeben, wird ein neuer, flüchtiger Satz von Registrierungsinformationen (nur Arbeitsspeicher) oder hive erstellt. Wenn REG_WHOLE_HIVE_VOLATILE angegeben wird, 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 der Speicherort der Teilstruktur, auf die der hKey-Parameter verweist, unmittelbar nach der letzten Leerung in seinem Zustand 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 TCB-Berechtigung (Trusted Computing Base) verfügen. und das Handle, auf das sich der hKey-Parameter bezieht, muss auf den Stamm der Unterstruktur verweisen.

CallContext

Optionale vom Treiber definierte Kontextinformationen, die die RegistryCallback-Routine des Treibers bereitstellen kann. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.

ObjectContext

Ein Zeiger auf vom Treiber definierte Kontextinformationen, die der Treiber durch Aufrufen von CmSetCallbackObjectContext einem Registrierungsobjekt zugeordnet hat. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.

Reserved

Dieses Element ist für die zukünftige Verwendung reserviert. Dieser Member ist für Windows Vista und höhere Versionen des Windows-Betriebssystems definiert.

Hinweise

Das flag REG_REFRESH_HIVE 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
Unterstützte Mindestversion (Client) Verfügbar unter Windows Vista SP2 und höheren Versionen des Windows-Betriebssystems.
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

CmSetCallbackObjectContext

RegistryCallback