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


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

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

Синтаксис

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

Члены

Object

Указатель на объект раздела реестра для раздела, метаданные которого будут запрошены.

KeyInformationClass

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

KeyInformation

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

Length

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

ResultLength

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

CallContext

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

ObjectContext

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

Reserved

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

Комментарии

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

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

Требования

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

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

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey