IoWMIHandleToInstanceName function (wdm.h)

  • Article

The IoWMIHandleToInstanceName routine determines the instance name for the WMI class instance implemented by the driver that is specified by a file handle.

Syntax

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

Parameters

[in] DataBlockObject

Pointer to a WMI data block object. The caller opens the data block object for the WMI class with the IoWMIOpenBlock routine.

[in] FileHandle

Specifies a file handle. The routine returns the instance name corresponding to the driver that is represented by the file handle.

[out] InstanceName

Pointer to the UNICODE_STRING structure that the routine uses to return the instance name. The caller frees the returned buffer within UNICODE_STRING.

Return value

The routine returns an NTSTATUS code. Possible return values include:

Return code Description
STATUS_SUCCESS
 The operation succeeded. The routine fills the UNICODE_STRING structure pointed to by the InstanceName parameter with the instance name.
STATUS_WMI_INSTANCE_NOT_FOUND
 The driver does not implement any instances of the WMI class specified by DataBlockObject.

Requirements

Requirement Value
Minimum supported client Available in Windows XP and later versions of the Windows operating system.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

See also

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock