REG_QUERY_VALUE_KEY_INFORMATION structure (wdm.h)

La structure REG_QUERY_VALUE_KEY_INFORMATION contient des informations sur l’entrée de valeur d’une clé de Registre qui est interrogée.

Syntaxe

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé dont l’entrée de valeur est interrogée.

ValueName

Pointeur vers une structure UNICODE_STRING qui contient le nom de l’entrée de valeur pour laquelle récupérer des informations.

KeyValueInformationClass

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

KeyValueInformation

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 KeyValueInformationClass. Pour plus d’informations , consultez KEY_VALUE_INFORMATION_CLASS.

Length

Taille, en octets, de la mémoire tampon KeyValueInformation .

ResultLength

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

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é 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 à une routine RegistryCallback chaque fois qu’un thread tente d’interroger une entrée de valeur pour une clé, par exemple lorsqu’un thread en mode utilisateur appelle RegQueryValue ou RegQueryValueEx ou lorsqu’un pilote appelle ZwDeleteKey.

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

Configuration requise

Voir aussi

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey