REG_ENUMERATE_VALUE_KEY_INFORMATION structure (wdm.h)

  • Article

La structure REG_ENUMERATE_VALUE_KEY_INFORMATION décrit une entrée de valeur d’une clé dont les entrées de valeur sont énumérées.

Syntaxe

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;

Membres

Object

Pointeur vers l’objet de clé de Registre pour la clé dont les entrées de valeur sont énumérées.

Index

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

KeyValueInformationClass

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

KeyValueInformation

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 KeyValueInformationClass. Pour plus d’informations , consultez KEY_VALUE_INFORMATION_CLASS.

Length

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

ResultLength

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

CallContext

Informations contextuelles 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 une entrée de valeur d’une clé, par exemple lorsqu’un thread en mode utilisateur appelle RegEnumValue ou lorsqu’un pilote appelle ZwEnumerateValueKey.

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

Configuration requise

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

Voir aussi

CmSetCallbackObjectContext

KEY_VALUE_INFORMATION_CLASS

RegistryCallback

ZwEnumerateValueKey