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 SP2 及更高版本的 Windows 操作系统。
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）

另请参阅

CmSetCallbackObjectContext

RegistryCallback