структура REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION (wdm.h)
Структура REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION описывает несколько записей значений, которые извлекаются для ключа.
Синтаксис
typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
PVOID Object;
PKEY_VALUE_ENTRY ValueEntries;
ULONG EntryCount;
PVOID ValueBuffer;
PULONG BufferLength;
PULONG RequiredBufferLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;
Члены
Object
Указатель на объект раздела реестра для ключа, записи значений которого извлекаются.
ValueEntries
Указатель на массив KEY_VALUE_ENTRY структур, по одному для каждой извлекаемой записи значения.
EntryCount
Количество записей в массиве ValueEntries .
ValueBuffer
Указатель на буфер, который получает (из системы) данные для всех записей значений, заданных массивом ValueEntries .
BufferLength
Указатель на переменную, содержащую длину буфера ValueBuffer (в байтах).
RequiredBufferLength
Указатель на переменную, которая получает (из системы) количество байтов, необходимых для хранения данных для всех записей значений, определенных массивом ValueEntries . Этот элемент может иметь значение NULL.
CallContext
Необязательные сведения о контексте, определяемые драйвером, которые может предоставлять подпрограмма RegistryCallback драйвера. Этот член определяется для Windows Vista и более поздних версий операционной системы Windows.
ObjectContext
Указатель на определяемые драйвером контекстные сведения, связанные драйвером с объектом реестра путем вызова CmSetCallbackObjectContext. Этот член определяется для Windows Vista и более поздних версий операционной системы Windows.
Reserved
Этот элемент зарезервирован для использования в будущем. Этот член определяется для Windows Vista и более поздних версий операционной системы Windows.
Комментарии
Система передает эту структуру в подпрограмму RegistryCallback каждый раз, когда поток пытается получить несколько записей значений для ключа одновременно, например, когда поток пользовательского режима вызывает RegQueryMultipleValues.
Каждая KEY_VALUE_ENTRY структура в массиве ValueEntries описывает одну запись значения в буфере ValueBuffer . В частности, элемент DataOffsetKEY_VALUE_ENTRY содержит смещение в ValueBuffer , где начинаются данные для этой записи значения, а элемент DataLength содержит длину (в байтах) данных для этой записи значения.
Дополнительные сведения об операциях фильтрации реестра см. в разделе Фильтрация вызовов реестра.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows XP и более поздних версиях операционной системы Windows. |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |