Condividi tramite


struttura REG_ENUMERATE_KEY_INFORMATION (wdm.h)

La struttura REG_ENUMERATE_KEY_INFORMATION descrive una sottochiave di una chiave le cui sottochiavi vengono enumerate.

Sintassi

typedef struct _REG_ENUMERATE_KEY_INFORMATION {
  PVOID                 Object;
  ULONG                 Index;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_ENUMERATE_KEY_INFORMATION, *PREG_ENUMERATE_KEY_INFORMATION;

Membri

Object

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

Index

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

KeyInformationClass

Valore KEY_INFORMATION_CLASS che indica il tipo di informazioni da restituire dal sistema nel buffer KeyInformation.

KeyInformation

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

Length

Dimensioni, in byte, del buffer KeyInformation.

ResultLength

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

CallContext

Informazioni di contesto facoltative definite dal driver che il driver RegistryCallback routine 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 un uso futuro. Questo membro è definito per Windows Vista e versioni successive del sistema operativo Windows.

Osservazioni

Il sistema passa questa struttura a un RegistryCallback routine ogni volta che un thread tenta di enumerare le sottochiavi di una chiave, ad esempio quando un thread in modalità utente chiama RegEnumKey o RegEnumKeyEx o quando un driver chiama ZwEnumerateKey.

Per altre informazioni sulle operazioni di filtro del Registro di sistema, vedere Filtro delle chiamate del Registro di sistema.

Fabbisogno

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)

Vedere anche

CmSetCallbackObjectContext

KEY_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey