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

  • Статья

Структура REG_QUERY_VALUE_KEY_INFORMATION содержит сведения о запрашиваемой записи значения раздела реестра.

Синтаксис

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

Члены

Object

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

ValueName

Указатель на структуру UNICODE_STRING , содержащую имя записи значения, для которого требуется получить сведения.

KeyValueInformationClass

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

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 каждый раз, когда поток пытается запросить запись значения для ключа, например, когда поток пользовательского режима вызывает RegQueryValue или RegQueryValueEx или когда драйвер вызывает ZwDeleteKey.

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

Требования

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

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

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey