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 de 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 pelo ValueEntries matriz.
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 pelo ValueEntries matriz. Esse membro pode ser NULL.
CallContext
Informações de contexto definidas pelo driver opcionais que a rotina de registryCallback do driver podem 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
Esse membro é reservado para uso futuro. Esse membro é definido para o Windows Vista e versões posteriores do sistema operacional Windows.
Observações
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 no modo de usuário chama RegQueryMultipleValues.
Cada estrutura KEY_VALUE_ENTRY na matriz ValueEntries descreve uma entrada de valor no buffer ValueBuffer. Especificamente, o dataOffset membro do KEY_VALUE_ENTRY contém o deslocamento dentro 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 |
---|---|
de cliente com suporte mínimo | 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) |