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

Функция IoWMIQueryAllData (wdm.h)

  • Статья

Подпрограмма IoWMIQueryAllData возвращает все блоки данных WMI, реализующие заданный класс WMI.

Синтаксис

NTSTATUS IoWMIQueryAllData(
  [in]            PVOID  DataBlockObject,
  [in, out]       PULONG InOutBufferSize,
  [out, optional] PVOID  OutBuffer
);

Параметры

[in] DataBlockObject

Указатель на объект блока данных WMI. Вызывающий объект открывает объект блока данных для класса WMI с помощью процедуры IoWMIOpenBlock . Объект должен быть открыт с правом доступа WMIGUID_QUERY.

[in, out] InOutBufferSize

Указатель на расположение памяти, указывающее размер буфера, передаваемого в параметре OutBuffer . Если подпрограмма завершается успешно, она обновляет расположение в памяти, указывая количество байтов, фактически хранящихся в OutBuffer. Если подпрограмма завершается сбоем с кодом состояния STATUS_BUFFER_TOO_SMALL, она возвращает количество байтов, необходимое для возврата данных.

[out, optional] OutBuffer

Указатель на буфер, в который подпрограмма возвращает данные WMI. Подпрограмма возвращает последовательность структур WNODE_ALL_DATA переменной величины, по одной для каждого набора возвращаемых блоков данных. Элемент WnodeHeader.Linkage каждой структуры WNODE_ALL_DATA содержит смещение от начала текущего WNODE_ALL_DATA до начала следующего WNODE_ALL_DATA. Последний блок в цепочке имеет значение WnodeHeader.Linkage , равный нулю. OutBuffer должен указывать на буфер, выделенный из невыгружаемого пула.

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

Подпрограмма возвращает код NTSTATUS. Возможные возвращаемые значения:

Код возврата Описание
STATUS_SUCCESS
 Операция успешно выполнена. Подпрограмма возвращает данные WMI в буфере, на который указывает параметр OutBuffer . Подпрограмма также возвращает размер возвращаемых данных в байтах в расположении памяти, на который указывает параметр InOutBufferSize .
STATUS_WMI_GUID_NOT_FOUND
 Ни одно из драйверов не реализует указанный класс WMI.
STATUS_BUFFER_TOO_SMALL
 Буфер, передаваемый вызывающим объектом в параметре OutBuffer , слишком мал. Подпрограмма возвращает требуемый размер буфера в расположении памяти, на который указывает параметр InOutBufferSize .

Комментарии

IoWMIQueryAllData определяет, какие драйверы поддерживают указанный класс WMI, и отправляет запрос IRP_MN_QUERY_ALL_DATA каждому такому драйверу.

Для запроса нескольких классов WMI используйте IoWMIQueryAllDataMultiple.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows XP и более поздних версиях операционной системы Windows.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

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

IRP_MN_QUERY_ALL_DATA

IoWMIOpenBlock

IoWMIQueryAllDataMultiple