Partager via


structure REG_RESTORE_KEY_INFORMATION (wdm.h)

La structure REG_RESTORE_KEY_INFORMATION contient les informations d’une clé de Registre 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 vers le fichier à partir duquel la ruche sera restaurée.

Flags

REG_FORCE_RESTORE

0x0000008L

Si elle est spécifiée, l’opération de restauration est exécutée même si des handles ouverts existent à l’emplacement ou sous l’emplacement dans la hiérarchie du Registre auquel le hKey points de paramètre.

REG_WHOLE_HIVE_VOLATILE

0x00000001L

S’il est spécifié, un jeu d’informations de Registre nouveau et volatile (mémoire uniquement) ou ruche, 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 elle est définie, l’emplacement de la sous-arborescence à laquelle pointe le paramètre hKey est restauré à son état immédiatement après la dernière vidage. La sous-arborescence ne doit pas être vidée paresseux (en appelant RegRestoreKey avec REG_NO_LAZY_FLUSH spécifiée comme valeur de ce paramètre) ; l’appelant doit disposer du privilège TCB (Trusted Computing Base) ; et le handle auquel le paramètre hKey fait référence doit pointer vers la racine de la sous-arborescence.

CallContext

Informations contextuelles 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é à une utilisation ultérieure. 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 appels de Registre de filtrage.

Exigences

Exigence Valeur
client minimum pris en charge Disponible sur Windows Vista SP2 et versions ultérieures du système d’exploitation Windows.
d’en-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

RegistryCallback