IoWMIHandleToInstanceName 函数 (wdm.h)

  • 项目

IoWMIHandleToInstanceName 例程确定由文件句柄指定的驱动程序实现的 WMI 类实例的实例名称。

语法

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

参数

[in] DataBlockObject

指向 WMI 数据块对象的指针。 调用方使用 IoWMIOpenBlock 例程打开 WMI 类的数据块对象。

[in] FileHandle

指定文件句柄。 例程返回与由文件句柄表示的驱动程序对应的实例名称。

[out] InstanceName

指向例程用于返回实例名称 的UNICODE_STRING 结构的指针。 调用方释放 UNICODE_STRING内返回的缓冲区。

返回值

例程返回 NTSTATUS 代码。 可能的返回值包括：

返回代码 说明
STATUS_SUCCESS
 操作成功。 例程使用实例名称填充 InstanceName 参数指向的UNICODE_STRING结构。
STATUS_WMI_INSTANCE_NOT_FOUND
 驱动程序不实现 DataBlockObject 指定的 WMI 类的任何实例。

要求

要求 值
最低受支持的客户端 在 Windows XP 和更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock