Partager via


structure REG_QUERY_KEY_INFORMATION (wdm.h)

La structure REG_QUERY_KEY_INFORMATION décrit les métadonnées qui sont sur le point d’être interrogées pour une clé.

Syntaxe

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé dont les métadonnées sont sur le point d’être interrogées.

KeyInformationClass

Valeur KEY_INFORMATION_CLASS qui indique le type d’informations à retourner par le système.

KeyInformation

Pointeur vers une mémoire tampon qui contient les informations à retourner par le système. Le format de la mémoire tampon dépend de la valeur de KeyInformationClass. Pour plus d’informations , consultez KEY_INFORMATION_CLASS.

Length

Spécifie la taille, en octets, de la mémoire tampon KeyInformation .

ResultLength

Pointeur vers une variable qui reçoit (du système) la quantité de données valides, en octets, dans la mémoire tampon KeyInformation .

CallContext

Informations de contexte 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é pour un usage ultérieur. Ce membre est défini pour Windows Vista et les versions ultérieures du système d’exploitation Windows.

Remarques

Le système transmet cette structure à la routine RegistryCallback chaque fois qu’un thread tente d’interroger les métadonnées d’une clé, par exemple, lorsqu’un thread en mode utilisateur appelle RegQueryInfoKey ou lorsqu’un pilote appelle ZwQueryKey.

Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels du Registre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible sur Microsoft Windows XP et les versions ultérieures du système d’exploitation Windows.
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey