Метод IRegistryKey::QueryRegistryValues (portcls.h)

Статья
02/07/2025

Метод QueryRegistryValues позволяет вызывающему объекту запрашивать несколько значений из реестра с одним вызовом.

Синтаксис

NTSTATUS QueryRegistryValues(
  [in]           PRTL_QUERY_REGISTRY_TABLE QueryTable,
  [in, optional] PVOID                     Context
);

Параметры

[in] QueryTable

Указатель на массив одной или нескольких структур RTL_QUERY_REGISTRY_TABLE. (Эта структура описана в RtlQueryRegistryValues.) Каждая структура задает имя значения и имя подраздела для записи реестра, запрашиваемой вызывающим элементом. Каждая структура также содержит указатель функции на вызываемую QueryRoutine обратного вызова, который метод QueryRegistryValues будет вызывать с информацией о соответствующей записи реестра. Массив должен быть завершен структурой с элементом имени, который NULL.

[in, optional] Context

Это значение контекста, определяемое вызывающим объектом. Метод QueryRegistryValues передает это значение в качестве параметра вызова каждому из обратных вызовов QueryRoutine. Значение контекста обычно является указателем на определяемую вызывающим объектом структуру, содержащую данные контекста, к которым обращается вызывающий объект QueryRoutine. Значение контекста приведение к типу PVOID указателя, но метод QueryRegistryValues не выполняет проверку указателя.

Возвращаемое значение

QueryRegistryValues возвращает STATUS_SUCCESS, если вызов был успешно выполнен при обработке всего queryTable. В противном случае метод возвращает соответствующий код ошибки. В следующей таблице показаны некоторые возможные коды состояния возврата.

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Указывает, что параметр QueryTable, переданный методу, недопустим.
STATUS_OBJECT_NAME_NOT_FOUND	Указывает, что метод не удалось найти объект, указанный в одной из записей QueryTable.

Замечания

Этот метод использует подпрограммы обратного вызова, предоставленные вызывающим методом, для перечисления значений списка записей реестра. В случае успешного выполнения метод возвращается после вызова всех подпрограмм обратного вызова в списке.

Параметр QueryTable указывает на массив структур RTL_QUERY_REGISTRY_TABLE. Первый элемент этой структуры, QueryRoutine, является указателем функции на подпрограмму обратного вызова, предоставленного вызывающим. Дополнительные сведения см. в разделе RtlQueryRegistryValues.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL

См. также

IRegistryKey

RtlQueryRegistryValues

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