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

Статья
02/07/2025

Структура 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

0x000000008L

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

REG_WHOLE_HIVE_VOLATILE

0x000000001L

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

REG_REFRESH_HIVE

0x00000002

Если задано, расположение поддерев, на которое указывает параметр hKey, будет восстановлено состояние сразу после последнего сброса. Поддерев не должен быть отложенным (путем вызова RegRestoreKey с REG_NO_LAZY_FLUSH, указанным в качестве значения этого параметра); вызывающий объект должен иметь привилегию доверенной вычислительной базы (TCB); и дескриптор, к которому относится параметр hKey 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 (include Wdm.h, Ntddk.h, Ntifs.h)

См. также

CmSetCallbackObjectContext

RegistryCallback

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