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

Статья
02/07/2025

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

Каждая структура KEY_VALUE_ENTRY в массиве ValueEntries описывает одну запись значения в буфере ValueBuffer. В частности, элемент DataOffsetKEY_VALUE_ENTRY содержит смещение в ValueBuffer, где начинаются данные для этой записи значения, а элемент DataLength содержит длину в байтах данных для этой записи значений.

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

Требования

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

См. также

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback

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