estrutura REG_ENUMERATE_VALUE_KEY_INFORMATION (wdm.h)

  • Artigo

A estrutura REG_ENUMERATE_VALUE_KEY_INFORMATION descreve uma entrada de valor de uma chave cujas entradas de valor estão sendo enumeradas.

Sintaxe

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;

Membros

Object

Um ponteiro para o objeto de chave do Registro para a chave cujas entradas de valor estão sendo enumeradas.

Index

O índice baseado em zero da subchave dentro da chave.

KeyValueInformationClass

O valor KEY_VALUE_INFORMATION_CLASS que indica o tipo de informação a ser retornado pelo sistema no buffer KeyValueInformation .

KeyValueInformation

Um ponteiro para um buffer que contém as informações a serem retornadas pelo sistema. O formato do buffer depende do valor de KeyValueInformationClass. Para obter mais informações , consulte KEY_VALUE_INFORMATION_CLASS.

Length

O tamanho, em bytes, do buffer KeyValueInformation .

ResultLength

Um ponteiro para uma variável que recebe (do sistema) a quantidade de dados válidos, em bytes, no buffer KeyValueInformation .

CallContext

Informações de contexto opcionais definidas pelo driver que a rotina RegistryCallback do driver pode fornecer. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

ObjectContext

Um ponteiro para informações de contexto definidas pelo driver que o driver associou a um objeto do Registro chamando CmSetCallbackObjectContext. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

Reserved

Este membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.

Comentários

O sistema passa essa estrutura para uma rotina RegistryCallback sempre que um thread tenta enumerar uma entrada de valor de uma chave, por exemplo, quando um thread de modo de usuário chama RegEnumValue ou quando um driver chama ZwEnumerateValueKey.

Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas de registro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows XP e versões posteriores do sistema operacional Windows.
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

CmSetCallbackObjectContext

KEY_VALUE_INFORMATION_CLASS

RegistryCallback

ZwEnumerateValueKey