Поделиться через

структура REG_RESTORE_KEY_INFORMATION (wdm.h)

  • Статья

Структура REG_RESTORE_KEY_INFORMATION содержит сведения о разделе реестра, который должен быть восстановлен.

Синтаксис

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;

Члены

Object

Указатель на объект раздела реестра для раздела, который должен быть восстановлен.

FileHandle

Дескриптор файла, из которого будет восстановлен куст.

Flags

REG_FORCE_RESTORE

0x00000008L

Если указано, операция восстановления выполняется, даже если открытые дескрипторы существуют в расположении или под расположением в иерархии реестра, на которое указывает параметр hKey .

REG_WHOLE_HIVE_VOLATILE

0x00000001L

Если этот параметр указан, создается новый, энергонезависимый (только для памяти) набор сведений о реестре или куст. Если указан REG_WHOLE_HIVE_VOLATILE, ключ, определяемый параметром hKey , должен быть HKEY_USERS или HKEY_LOCAL_MACHINE значением.

REG_REFRESH_HIVE

0x00000002

Если задано значение , то расположение поддеревого, на которое указывает параметр hKey , восстанавливается в состояние сразу после последней очистки. Поддеревье не должно быть отложенным (путем вызова RegRestoreKey с REG_NO_LAZY_FLUSH в качестве значения этого параметра); вызывающий объект должен иметь привилегию доверенной вычислительной базы (TCB); и дескриптор, на который ссылается параметр hKey , должен указывать на корень поддеревого.

CallContext

Необязательные сведения о контексте, определяемые драйвером, которые может предоставить подпрограмма RegistryCallback драйвера. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

ObjectContext

Указатель на определяемые драйвером контекстные сведения, связанные драйвером с объектом реестра путем вызова CmSetCallbackObjectContext. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

Reserved

Этот элемент зарезервирован для использования в будущем. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

Комментарии

Флаг REG_REFRESH_HIVE непрозрачн, и фильтр не должен пытаться его изменить.

Дополнительные сведения об операциях фильтрации реестра см. в разделе Фильтрация вызовов реестра.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista с пакетом обновления 2 (SP2) и более поздних версиях операционной системы Windows.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

CmSetCallbackObjectContext

RegistryCallback