Edit

Share via

REG_RESTORE_KEY_INFORMATION structure (wdm.h)

  • Article

The REG_RESTORE_KEY_INFORMATION structure contains the information for a registry key that is about to be restored.

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;

Members

Object

A pointer to a registry key object for the key that is about to be restored.

FileHandle

A handle to the file from which the hive will be restored.

Flags

REG_FORCE_RESTORE

0x00000008L

If specified, the restore operation is executed even if open handles exist at or beneath the location in the registry hierarchy to which the hKey parameter points.

REG_WHOLE_HIVE_VOLATILE

0x00000001L

If specified, a new, volatile (memory-only) set of registry information, or hive, is created. If REG_WHOLE_HIVE_VOLATILE is specified, the key identified by the hKey parameter must be either the HKEY_USERS or HKEY_LOCAL_MACHINE value.

REG_REFRESH_HIVE

0x00000002

If set, the location of the subtree that the hKey parameter points to is restored to its state immediately following the last flush. The subtree must not be lazy flushed (by calling RegRestoreKey with REG_NO_LAZY_FLUSH specified as the value of this parameter); the caller must have the trusted computing base (TCB) privilege; and the handle to which the hKey parameter refers must point to the root of the subtree.

CallContext

Optional driver-defined context information that the driver's RegistryCallback routine can supply. This member is defined for Windows Vista and later versions of the Windows operating system.

ObjectContext

A pointer to driver-defined context information, which the driver has associated with a registry object by calling CmSetCallbackObjectContext. This member is defined for Windows Vista and later versions of the Windows operating system.

Reserved

This member is reserved for future use. This member is defined for Windows Vista and later versions of the Windows operating system.

Remarks

The REG_REFRESH_HIVE flag is opaque and a filter should not attempt to change it.

For more information about registry filtering operations, see Filtering Registry Calls.

Requirements

Requirement Value
Minimum supported client Available on Windows Vista SP2 and later versions of the Windows operating system.
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

CmSetCallbackObjectContext

RegistryCallback