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

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

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback