structure REG_ENUMERATE_KEY_INFORMATION (wdm.h)

La structure REG_ENUMERATE_KEY_INFORMATION décrit une sous-clé d’une clé dont les sous-clés sont énumérées.

Syntaxe

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;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé dont les sous-clés sont énumérées.

Index

Index de base zéro de la sous-clé dans la clé.

KeyInformationClass

Valeur KEY_INFORMATION_CLASS qui indique le type d’informations à retourner par le système dans la mémoire tampon KeyInformation .

KeyInformation

Pointeur vers une mémoire tampon qui contient les informations à retourner par le système. Le format de la mémoire tampon dépend de la valeur de KeyInformationClass. Pour plus d’informations, consultez KEY_INFORMATION_CLASS.

Length

Taille, en octets, de la mémoire tampon KeyInformation .

ResultLength

Pointeur vers un ULONG qui reçoit (du système) la quantité de données valides, en octets, dans la mémoire tampon KeyInformation .

CallContext

Informations de contexte 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 à une routine RegistryCallback chaque fois qu’un thread tente d’énumérer les sous-clés d’une clé, par exemple lorsqu’un thread en mode utilisateur appelle RegEnumKey ou RegEnumKeyEx ou lorsqu’un pilote appelle ZwEnumerateKey.

Pour plus d’informations sur les opérations de filtrage du Registre, consultez Filtrage des appels du Registre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible sur Microsoft Windows XP et les versions ultérieures du système d’exploitation Windows.
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

CmSetCallbackObjectContext

KEY_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey