estrutura REG_ENUMERATE_KEY_INFORMATION (wdm.h)

  • Artigo

A estrutura REG_ENUMERATE_KEY_INFORMATION descreve uma subchave de uma chave cujas subchaves estão sendo enumeradas.

Sintaxe

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;

Membros

Object

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

Index

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

KeyInformationClass

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

KeyInformation

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

Length

O tamanho, em bytes, do buffer KeyInformation .

ResultLength

Um ponteiro para um ULONG que recebe (do sistema) a quantidade de dados válidos, em bytes, no buffer KeyInformation .

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 as subchaves de uma chave, por exemplo, quando um thread no modo de usuário chama RegEnumKey ou RegEnumKeyEx ou quando um driver chama ZwEnumerateKey.

Para obter mais informações sobre operações de filtragem de registro, consulte Filtrando chamadas do 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_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey