Функция IoWMIQuerySingleInstanceMultiple (wdm.h)
Подпрограмма IoWMIQuerySingleInstanceMultiple возвращает все экземпляры блоков данных WMI, реализующие указанные классы WMI с указанными именами экземпляров.
Синтаксис
NTSTATUS IoWMIQuerySingleInstanceMultiple(
[in] PVOID *DataBlockObjectList,
[in] PUNICODE_STRING InstanceNames,
[in] ULONG ObjectCount,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
Параметры
[in] DataBlockObjectList
Указатель на массив указателей объектов блоков данных WMI. Вызывающий объект открывает объект блока данных для каждого класса WMI с помощью процедуры IoWMIOpenBlock . Каждый объект должен быть открыт с правом доступа WMIGUID_QUERY.
[in] InstanceNames
Указатель на массив UNICODE_STRING структур, содержащих имена экземпляров. N-еимя экземпляра в массиве соответствует значению свойства InstanceName для n-гокласса WMI, указанного в массиве, на который указывает параметр DataBlockObjectList.
[in] ObjectCount
Указывает количество записей в массивах, передаваемых в параметрах DataBlockObjectList и InstanceNames .
[in, out] InOutBufferSize
Указатель на расположение памяти, указывающее размер буфера, передаваемого в параметре OutBuffer . Если подпрограмма завершается успешно, она обновляет расположение в памяти, указывая количество байтов, фактически хранящихся в OutBuffer. Если подпрограмма завершается сбоем с STATUS_BUFFER_TOO_SMALL, она возвращает количество байтов, необходимое для возврата данных.
[out, optional] OutBuffer
Указатель на буфер, в который подпрограмма возвращает данные WMI. Подпрограмма возвращает последовательность структур WNODE_SINGLE_INSTANCE переменной величины, по одной для каждого экземпляра блока данных. Элемент WnodeHeader.Linkage каждой структуры WNODE_SINGLE_INSTANCE содержит смещение от начала текущего WNODE_SINGLE_INSTANCE до начала следующего WNODE_SINGLE_INSTANCE. Последний блок в цепочке имеет значение WnodeHeader.Linkage , равный нулю. Каждый отдельный экземпляр блока данных соответствует одному соответствующему классу WMI и имени экземпляра. OutBuffer должен указывать на буфер, выделенный из невыгружаемого пула.
Возвращаемое значение
Подпрограмма возвращает код NTSTATUS. Возможные возвращаемые значения:
Код возврата | Описание |
---|---|
|
Операция успешно выполнена. Подпрограмма возвращает данные WMI в буфере, на который указывает параметр OutBuffer . Подпрограмма также возвращает размер возвращаемых данных в байтах в расположении памяти, на который указывает параметр InOutBufferSize . |
|
Буфер, передаваемый вызывающим объектом в параметре OutBuffer , слишком мал. Подпрограмма возвращает требуемый размер буфера в расположении памяти, на который указывает параметр InOutBufferSize . |
Комментарии
IoWMIQuerySingleInstanceMultiple определяет, какие драйверы могут поддерживать указанные классы WMI и имена экземпляров, и выдает запрос IRP_MN_QUERY_SINGLE_INSTANCE каждому такому драйверу. Каждый драйвер, экспортируемый экземпляр блока данных с соответствующим свойством InstanceName , возвращает соответствующие данные.
Если ни один из драйверов не реализует какие-либо из указанных классов WMI и имен экземпляров, подпрограмма возвращает STATUS_SUCCESS. Он также возвращает нулевое значение в расположении памяти, на которое указывает параметр InOutBufferSize .
Чтобы запросить один класс WMI и имя экземпляра, используйте процедуру IoWMIQuerySingleInstance . Драйверы могут использовать подпрограмму IoWMISetSingleInstance для обновления экземпляра класса.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в Windows XP и более поздних версиях операционной системы Windows. |
Целевая платформа | Универсальное |
Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
Библиотека | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по