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

要从中还原 hive 的文件的句柄。

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