structure REG_RESTORE_KEY_INFORMATION (wdm.h)

Article
02/29/2024

La structure REG_RESTORE_KEY_INFORMATION contient les informations relatives à une clé de Registre qui est sur le point d’être restaurée.

Syntaxe

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;

Membres

Object

Pointeur vers un objet de clé de Registre pour la clé qui est sur le point d’être restaurée.

FileHandle

Handle du fichier à partir duquel la ruche sera restaurée.

Flags

REG_FORCE_RESTORE

0x00000008L

Si elle est spécifiée, l’opération de restauration est exécutée même si des handles ouverts existent au niveau ou en dessous de l’emplacement dans la hiérarchie du Registre vers lequel pointe le paramètre hKey .

REG_WHOLE_HIVE_VOLATILE

0x00000001L

S’il est spécifié, un nouvel ensemble volatile (mémoire uniquement) d’informations du Registre, ou hive, est créé. Si REG_WHOLE_HIVE_VOLATILE est spécifié, la clé identifiée par le paramètre hKey doit être la valeur HKEY_USERS ou HKEY_LOCAL_MACHINE.

REG_REFRESH_HIVE

0x00000002

Si la valeur est définie, l’emplacement de la sous-arborescence vers laquelle pointe le paramètre hKey est restauré à son état immédiatement après le dernier vidage. La sous-arborescence ne doit pas être vidée de la paresse (en appelant RegRestoreKey avec REG_NO_LAZY_FLUSH spécifiée comme valeur de ce paramètre) ; l’appelant doit disposer du privilège de base de calcul approuvé (TCB) ; et le handle auquel le paramètre hKey fait référence doit pointer vers la racine de la sous-arborescence.

CallContext

Informations de contexte facultatives définies par le pilote que la routine RegistryCallback du pilote peut fournir. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.

ObjectContext

Pointeur vers les informations de contexte définies par le pilote, que le pilote a associées à un objet de Registre en appelant CmSetCallbackObjectContext. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.

Reserved

Ce membre est réservé pour un usage ultérieur. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.

Remarques

L’indicateur REG_REFRESH_HIVE est opaque et un filtre ne doit pas tenter de le modifier.

Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels du Registre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible sur Windows Vista SP2 et versions ultérieures du système d’exploitation Windows.
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

RegistryCallback

Partager via