Поделиться через


структура 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 (include Wdm.h, Ntddk.h, Ntifs.h)

См. также

CmSetCallbackObjectContext

KEY_INFORMATION_CLASS

RegistryCallback

ZwEnumerateKey