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

  • Статья

Структура REG_ENUMERATE_KEY_INFORMATION описывает один подраздел ключа, подразделы которого перечисляются.

Синтаксис

typedef struct _REG_ENUMERATE_KEY_INFORMATION {
  PVOID                 Object;
  ULONG                 Index;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_ENUMERATE_KEY_INFORMATION, *PREG_ENUMERATE_KEY_INFORMATION;

Члены

Object

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

Index

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

KeyInformationClass

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

KeyInformation

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

Length

Размер (в байтах) буфера KeyInformation .

ResultLength

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

CallContext

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

ObjectContext

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

Reserved

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

Комментарии

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

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

Требования

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

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

CmSetCallbackObjectContext

KEY_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey