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

  • Статья

Структура REG_ENUMERATE_VALUE_KEY_INFORMATION описывает одну запись значения ключа, в котором перечисляются записи значений.

Синтаксис

typedef struct _REG_ENUMERATE_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  ULONG                       Index;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_ENUMERATE_VALUE_KEY_INFORMATION, *PREG_ENUMERATE_VALUE_KEY_INFORMATION;

Члены

Object

Указатель на объект раздела реестра для раздела, для которого перечисляются записи значений.

Index

Отсчитываемый от нуля индекс подраздела в ключе.

KeyValueInformationClass

Значение KEY_VALUE_INFORMATION_CLASS , указывающее тип сведений, возвращаемых системой в буфере KeyValueInformation .

KeyValueInformation

Указатель на буфер, содержащий сведения, возвращаемые системой. Формат буфера зависит от значения KeyValueInformationClass. Дополнительные сведения см . в разделе KEY_VALUE_INFORMATION_CLASS.

Length

Размер буфера KeyValueInformation в байтах.

ResultLength

Указатель на переменную, которая получает (из системы) объем допустимых данных в байтах в буфере KeyValueInformation .

CallContext

Необязательные сведения о контексте, определяемые драйвером, которые может предоставить подпрограмма RegistryCallback драйвера. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

ObjectContext

Указатель на определяемые драйвером контекстные сведения, связанные драйвером с объектом реестра путем вызова CmSetCallbackObjectContext. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

Reserved

Этот элемент зарезервирован для использования в будущем. Этот элемент определен для Windows Vista и более поздних версий операционной системы Windows.

Комментарии

Система передает эту структуру в подпрограмму RegistryCallback каждый раз, когда поток пытается перечислить запись значения ключа, например, когда поток пользовательского режима вызывает RegEnumValue или когда драйвер вызывает ZwEnumerateValueKey.

Дополнительные сведения об операциях фильтрации реестра см. в разделе Фильтрация вызовов реестра.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows XP и более поздних версиях операционной системы Windows.
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)

См. также раздел

CmSetCallbackObjectContext

KEY_VALUE_INFORMATION_CLASS

RegistryCallback

ZwEnumerateValueKey