struttura REG_ENUMERATE_VALUE_KEY_INFORMATION (wdm.h)

Articolo
08/08/2023

La struttura REG_ENUMERATE_VALUE_KEY_INFORMATION descrive una voce di valore di una chiave le cui voci di valore vengono enumerate.

Sintassi

typedef struct _REG_ENUMERATE_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  ULONG                       Index;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_ENUMERATE_VALUE_KEY_INFORMATION, *PREG_ENUMERATE_VALUE_KEY_INFORMATION;

Members

Object

Puntatore all'oggetto chiave del Registro di sistema per la chiave di cui vengono enumerate le voci di valore.

Index

Indice in base zero della sottochiave all'interno della chiave.

KeyValueInformationClass

Valore KEY_VALUE_INFORMATION_CLASS che indica il tipo di informazioni da restituire dal sistema nel buffer KeyValueInformation .

KeyValueInformation

Puntatore a un buffer che contiene le informazioni da restituire dal sistema. Il formato del buffer dipende dal valore di KeyValueInformationClass. Per altre informazioni, vedere KEY_VALUE_INFORMATION_CLASS.

Length

Dimensioni, in byte, del buffer KeyValueInformation .

ResultLength

Puntatore a una variabile che riceve (dal sistema) la quantità di dati validi, in byte, nel buffer KeyValueInformation .

CallContext

Informazioni sul contesto facoltative definite dal driver che la routine RegistryCallback del driver può fornire. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

ObjectContext

Puntatore alle informazioni sul 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 a una routine RegistryCallback ogni volta che un thread tenta di enumerare una voce di valore di una chiave, ad esempio quando un thread in modalità utente chiama RegEnumValue o quando un driver chiama ZwEnumerateValueKey.

Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate al 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_INFORMATION_CLASS

RegistryCallback

ZwEnumerateValueKey

Condividi tramite