REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION structure (wdm.h)
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) |