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)

Vedi anche

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback