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) |