REG_UNLOAD_KEY_INFORMATION structure (wdm.h)
La structure REG_UNLOAD_KEY_INFORMATION contient des informations que la routine RegistryCallback d’un pilote peut utiliser lorsqu’une ruche de Registre est déchargée.
Syntaxe
typedef struct _REG_UNLOAD_KEY_INFORMATION {
PVOID Object;
PVOID UserEvent;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;
Membres
Object
Pointeur vers un objet de clé de Registre. Cet objet représente la clé racine de la ruche en cours de déchargement.
UserEvent
Pointeur vers un objet d’événement.
CallContext
Informations contextuelles facultatives définies par le pilote que la routine RegistryCallback du pilote peut fournir. Ce membre est défini à partir de Windows Vista.
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 à partir de Windows Vista.
Reserved
Ce membre est réservé pour un usage ultérieur. Ce membre est défini à partir de Windows Vista.
Remarques
Cette structure est utilisée par la routine RegistryCallback . Lorsque le paramètre Argument1 de la routine RegistryCallback est RegNtPreUnloadKey, le paramètre Argument2 est un pointeur vers une structure REG_UNLOAD_KEY_INFORMATION .
Le système d’exploitation transmet la structure REG_UNLOAD_KEY_INFORMATION à la routine RegistryCallback chaque fois qu’un thread tente de décharger une clé, par exemple, lorsqu’un thread en mode utilisateur appelle la fonction RegUnloadKey . En réponse à une notification RegNtPreUnloadKey , la routine RegistryCallback doit libérer toutes les ressources que le pilote a précédemment allouées pour être utilisées avec la ruche avant que la ruche ne soit déchargée.
Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels de registre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows Vista. |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |