REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION structure (wdm.h)

  • Article

La structure REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION décrit les entrées de valeur multiples récupérées pour une clé.

Syntaxe

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé dont les entrées de valeur sont récupérées.

ValueEntries

Pointeur vers un tableau de structures KEY_VALUE_ENTRY , un pour chaque entrée de valeur récupérée.

EntryCount

Nombre d’entrées dans le tableau ValueEntries .

ValueBuffer

Pointeur vers une mémoire tampon qui reçoit (du système) les données de toutes les entrées de valeur spécifiées par le tableau ValueEntries .

BufferLength

Pointeur vers une variable qui contient la longueur, en octets, de la mémoire tampon ValueBuffer .

RequiredBufferLength

Pointeur vers une variable qui reçoit (du système) le nombre d’octets requis pour contenir les données pour toutes les entrées de valeur spécifiées par le tableau ValueEntries . Ce membre peut être NULL.

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 à la routine RegistryCallback chaque fois qu’un thread tente de récupérer plusieurs entrées de valeur pour une clé à la fois, par exemple lorsqu’un thread en mode utilisateur appelle RegQueryMultipleValues.

Chaque structure KEY_VALUE_ENTRY dans le tableau ValueEntries décrit une entrée de valeur dans la mémoire tampon ValueBuffer . Plus précisément, le membre DataOffset de KEY_VALUE_ENTRY contient le décalage dans ValueBuffer où commencent les données de cette entrée de valeur, et le membre DataLength contient la longueur, en octets, des données de cette entrée de valeur.

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 sur Microsoft Windows XP et versions ultérieures du système d’exploitation Windows.
En-tête wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback