структура KEY_FULL_INFORMATION (wdm.h)

Статья
08/08/2023

Структура KEY_FULL_INFORMATION определяет сведения, доступные для раздела реестра, включая сведения о его подразделах и максимальную длину их имен и записей значений. Эти сведения можно использовать для изменения размера буферов для получения имен подразделов и их записей значений.

Синтаксис

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;

Члены

LastWriteTime

Время последнего изменения этого ключа или любого из его значений. Это значение времени выражается в абсолютном формате системного времени. Абсолютное системное время — это число 100-наносекундных интервалов с начала 1601 года в григорианском календаре.

TitleIndex

Устройства и промежуточные драйверы должны игнорировать этот элемент.

ClassOffset

Смещение в байтах от начала этой структуры до элемента Class .

ClassLength

Размер (в байтах) строки имени класса ключа в массиве Class .

SubKeys

Количество подразделов для этого ключа.

MaxNameLen

Максимальный размер (в байтах) любого имени подраздела.

MaxClassLen

Максимальный размер (в байтах) имени класса.

Values

Количество записей значений для этого ключа.

MaxValueNameLen

Максимальный размер (в байтах) имени записи значения.

MaxValueDataLen

Максимальный размер поля данных ввода значения (в байтах).

Class[1]

Массив расширенных символов, содержащий имя класса ключа. Эта символьная строка не заканчивается null. В определение структуры KEY_FULL_INFORMATION включен только первый элемент в этом массиве . Хранилище остальных элементов в массиве сразу же следует за этим элементом.

Подпрограммы ZwEnumerateKey и ZwQueryKey используют структуру KEY_FULL_INFORMATION для хранения полных сведений о разделе реестра. Если параметр KeyInformationClass любой из подпрограмм имеет значение KeyFullInformation, буфер KeyInformation обрабатывается как KEY_FULL_INFORMATION структура. Дополнительные сведения о значении перечисления KeyFullInformation см. в разделе KEY_INFORMATION_CLASS.