Partager via


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)

Voir aussi

CmSetCallbackObjectContext

RegistryCallback