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

  • Статья

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

Синтаксис

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

Параметры

[in] QueryTable

Указатель на массив одной или нескольких RTL_QUERY_REGISTRY_TABLE структур. (Эта структура описана в разделе RtlQueryRegistryValues.) Каждая структура указывает имя значения и имя подраздела для записи реестра, которую запрашивает вызывающий объект. Каждая структура также содержит указатель функции на обратный вызов QueryRoutine , предоставленный вызывающим объектом, который QueryRegistryValues вызывает метод с информацией о соответствующей записи реестра. Массив должен быть завершен структурой с элементом Name , имеющим значение 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 (включая Portcls.h)
IRQL PASSIVE_LEVEL

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

IRegistryKey

RtlQueryRegistryValues