IoWMIOpenBlock 函数 (wdm.h)

IoWMIOpenBlock 例程打开指定 WMI 类的 WMI 数据块对象。

语法

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

[in] Guid

指定 WMI 类的 GUID。

[in] DesiredAccess

指定对数据块对象所需的访问权限。调用方必须具有特定访问权限才能执行某些操作。

下面是每个访问权限位及其允许的操作的说明：

数据块对象可用于运行 WMI 类方法。必须将此标志设置为在数据块对象上使用 IoWMIExecuteMethod 。

数据块对象可用于注册事件通知回调。此标志必须设置为使用 IoWMISetNotificationCallback，并且只能用于 WMI 事件块。指定此标志的调用方还必须指定 SYNCHRONIZE 标志。

数据块对象可用于查询 WMI 类属性。必须将此标志设置为在数据块对象上使用任何 IoWMIQueryXxx 例程。

数据块对象可用于设置 WMI 类属性。必须将此标志设置为在数据块对象上使用任何 IoWMISetXxx 例程。

[out] DataBlockObject

指向内存位置的指针，其中例程返回指向数据块对象的指针。

成功时返回STATUS_SUCCESS，失败时返回相应的 NTSTATUS 错误代码。

调用方使用 IoWMIOpenBlock 为指定的 WMI 类 GUID 创建数据块对象。随后，调用方可以使用数据块对象来读取或写入 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.)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL