структура 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) |