estrutura KEY_FULL_INFORMATION (wdm.h)

Artigo
03/05/2024

A estrutura KEY_FULL_INFORMATION define as informações disponíveis para uma chave do Registro, incluindo informações sobre suas subchaves e o comprimento máximo para seus nomes e entradas de valor. Essas informações podem ser usadas para dimensionar buffers para obter os nomes das subchaves e suas entradas de valor.

Sintaxe

typedef struct _KEY_FULL_INFORMATION {
  LARGE_INTEGER LastWriteTime;
  ULONG         TitleIndex;
  ULONG         ClassOffset;
  ULONG         ClassLength;
  ULONG         SubKeys;
  ULONG         MaxNameLen;
  ULONG         MaxClassLen;
  ULONG         Values;
  ULONG         MaxValueNameLen;
  ULONG         MaxValueDataLen;
  WCHAR         Class[1];
} KEY_FULL_INFORMATION, *PKEY_FULL_INFORMATION;

Membros

LastWriteTime

A última vez que essa chave ou qualquer um de seus valores foi alterado. Dessa vez, o valor é expresso no formato de tempo absoluto do sistema. O tempo absoluto do sistema é o número de intervalos de 100 nanossegundos desde o início do ano de 1601 no calendário gregoriano.

TitleIndex

Os drivers intermediários e de dispositivo devem ignorar esse membro.

ClassOffset

O deslocamento de bytes do início dessa estrutura para o membro classe .

ClassLength

O tamanho, em bytes, da cadeia de caracteres de nome da classe de chave na matriz De classe .

SubKeys

O número de subchaves para essa chave.

MaxNameLen

O tamanho máximo, em bytes, de qualquer nome para uma subchave.

MaxClassLen

O tamanho máximo, em bytes, de um nome de classe.

Values

O número de entradas de valor para essa chave.

MaxValueNameLen

O tamanho máximo, em bytes, de um nome de entrada de valor.

MaxValueDataLen

O tamanho máximo, em bytes, de um campo de dados de entrada de valor.

Class[1]

Uma matriz de caracteres largos que contém o nome da classe da chave. Essa cadeia de caracteres não é terminada em nulo. Somente o primeiro elemento nessa matriz está incluído na definição de estrutura KEY_FULL_INFORMATION . O armazenamento dos elementos restantes na matriz segue imediatamente esse elemento.

Comentários

As rotinas ZwEnumerateKey e ZwQueryKey usam a estrutura KEY_FULL_INFORMATION para conter as informações completas de uma chave do Registro. Quando o parâmetro KeyInformationClass de qualquer rotina é KeyFullInformation, o buffer KeyInformation é tratado como uma estrutura KEY_FULL_INFORMATION . Para obter mais informações sobre o valor de enumeração KeyFullInformation , consulte KEY_INFORMATION_CLASS.