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

Статья
08/08/2023

Подпрограмма IoWMIOpenBlock открывает объект блока данных WMI для указанного класса WMI.

Синтаксис

NTSTATUS IoWMIOpenBlock(
  [in]  LPCGUID Guid,
  [in]  ULONG   DesiredAccess,
  [out] PVOID   *DataBlockObject
);

Параметры

[in] Guid

Указывает GUID для класса WMI.

[in] DesiredAccess

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

Ниже приведено описание каждого бита доступа и операций, которые он разрешает:

WMIGUID_EXECUTE

Объект блока данных можно использовать для выполнения методов класса WMI. Этот флаг должен быть установлен для использования IoWMIExecuteMethod в объекте блока данных.

WMIGUID_NOTIFICATION

Объект блока данных можно использовать для регистрации обратных вызовов уведомлений о событиях. Этот флаг должен быть установлен для использования IoWMISetNotificationCallback и может использоваться только для блоков событий WMI. Вызывающие стороны, указывающие этот флаг, также должны указывать флаг SYNCHRONIZE.

WMIGUID_QUERY

Объект блока данных можно использовать для запроса свойств класса WMI. Этот флаг необходимо задать для использования любой подпрограммы IoWMIQueryXxx в объекте блока данных.

WMIGUID_SET

Объект блока данных можно использовать для задания свойств класса WMI. Этот флаг должен быть установлен для использования любой подпрограммы IoWMISetXxx в объекте блока данных.

[out] DataBlockObject

Указатель на расположение памяти, где подпрограмма возвращает указатель на объект блока данных.

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

Возвращает STATUS_SUCCESS при успешном выполнении или соответствующий код ошибки NTSTATUS при сбое.

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

Используйте подпрограммы IoWMIQueryXxx и IoWMISetXxx для чтения и записи свойств класса WMI. Используйте IoWMIExecuteMethod для запуска методов класса WMI и IoWMISetNotificationCallback для регистрации обратного вызова уведомления о событии WMI.

Используйте ObDereferenceObject , чтобы закрыть объект блока данных, когда он больше не нужен.

Требования

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