estrutura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION (wdm.h)

A estrutura REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION descreve as várias entradas de valor que estão sendo recuperadas para uma chave.

Sintaxe

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

Membros

Object

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

ValueEntries

Um ponteiro para uma matriz de estruturas KEY_VALUE_ENTRY , uma para cada entrada de valor recuperada.

EntryCount

O número de entradas na matriz ValueEntries .

ValueBuffer

Um ponteiro para um buffer que recebe (do sistema) os dados de todas as entradas de valor especificadas pela matriz ValueEntries .

BufferLength

Um ponteiro para uma variável que contém o comprimento, em bytes, do buffer ValueBuffer .

RequiredBufferLength

Um ponteiro para uma variável que recebe (do sistema) o número de bytes necessários para manter os dados de todas as entradas de valor especificadas pela matriz ValueEntries . Esse membro pode ser NULL.

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 a rotina RegistryCallback sempre que um thread tenta recuperar várias entradas de valor para uma chave de uma só vez, por exemplo, quando um thread de modo de usuário chama RegQueryMultipleValues.

Cada estrutura KEY_VALUE_ENTRY na matriz ValueEntries descreve uma entrada de valor no buffer ValueBuffer . Especificamente, o membro DataOffset de KEY_VALUE_ENTRY contém o deslocamento no ValueBuffer em que os dados dessa entrada de valor começam e o membro DataLength contém o comprimento, em bytes, dos dados dessa entrada de valor.

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_ENTRY

RegistryCallback