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

Статья
02/07/2025

Подпрограмма IoWMIQuerySingleInstance возвращает указанный экземпляр блока данных WMI.

Синтаксис

NTSTATUS IoWMIQuerySingleInstance(
  [in]            PVOID           DataBlockObject,
  [in]            PUNICODE_STRING InstanceName,
  [in, out]       PULONG          InOutBufferSize,
  [out, optional] PVOID           OutBuffer
);

Параметры

[in] DataBlockObject

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

[in] InstanceName

Указывает имя экземпляра блока данных. Это значение соответствует значению свойства InstanceName для блока.

[in, out] InOutBufferSize

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

[out, optional] OutBuffer

Указатель на буфер, в котором подпрограмма возвращает данные WMI. Подпрограмма возвращает структуру WNODE_SINGLE_INSTANCE размера переменной. OutBuffer должны указывать на буфер, выделенный из непагрегированного пула.

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

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

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

Замечания

IoWMIQuerySingleInstance определяет, какие драйверы могут поддерживать указанный класс WMI с указанным именем экземпляра и выдает запрос IRP_MN_QUERY_SINGLE_INSTANCE каждому такому драйверу. Драйвер, экспортируемый экземпляр блока данных с соответствующим свойством instanceName InstanceName, возвращает соответствующие данные.

Чтобы запросить несколько классов WMI и имен экземпляров, используйте подпрограмму IoWMIQuerySingleInstanceMultiple. Драйверы могут использовать подпрограмму IoWMISetSingleInstance для обновления экземпляра класса.

Требования

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

См. также

IRP_MN_QUERY_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstanceMultiple

IoWMISetSingleInstance

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