structure REG_UNLOAD_KEY_INFORMATION (wdm.h)
La structure REG_UNLOAD_KEY_INFORMATION contient des informations que la routine de 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 qui est déchargée.
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 associées à un objet de Registre en appelant CmSetCallbackObjectContext. Ce membre est défini à partir de Windows Vista.
Reserved
Ce membre est réservé à une utilisation ultérieure. 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 de 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 les ressources que le pilote a précédemment allouées pour une utilisation avec la ruche avant le déchargement de la ruche.
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 à partir de Windows Vista. |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |