REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION struttura (wdm.h)
La struttura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION descrive le voci di più valori recuperate per una chiave.
Sintassi
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;
Members
Object
Puntatore all'oggetto chiave del Registro di sistema per la chiave il cui valore viene recuperato.
ValueEntries
Puntatore a una matrice di strutture KEY_VALUE_ENTRY , una per ogni voce di valore recuperata.
EntryCount
Numero di voci nella matrice ValueEntries .
ValueBuffer
Puntatore a un buffer che riceve (dal sistema) i dati per tutte le voci di valore specificate dalla matrice ValueEntries .
BufferLength
Puntatore a una variabile contenente la lunghezza, in byte, del buffer ValueBuffer .
RequiredBufferLength
Puntatore a una variabile che riceve (dal sistema) il numero di byte necessari per contenere i dati per tutte le voci di valore specificate dalla matrice ValueEntries . Questo membro può essere NULL.
CallContext
Informazioni di contesto definite dal driver facoltative che la routine RegistryCallback del driver può fornire. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.
ObjectContext
Puntatore a informazioni di contesto definite dal driver associate a un oggetto del Registro di sistema chiamando CmSetCallbackObjectContext. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.
Reserved
Questo membro è riservato per usi futuri. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.
Commenti
Il sistema passa questa struttura alla routine RegistryCallback ogni volta che un thread tenta di recuperare più voci di valore per una chiave, ad esempio quando un thread in modalità utente chiama RegQueryMultipleValues.
Ogni KEY_VALUE_ENTRY struttura nella matrice ValueEntries descrive una voce di valore nel buffer ValueBuffer. In particolare, il membro DataOffset di KEY_VALUE_ENTRY contiene l'offset all'interno di ValueBuffer in cui iniziano i dati per tale voce di valore e il membro DataLength contiene la lunghezza, in byte, dei dati per tale voce di valore.
Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows XP e versioni successive del sistema operativo Windows. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |