IoWMIHandleToInstanceName - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdm.h

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-wdm-iowmihandletoinstancename)

IoWMIHandleToInstanceName function

Description

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

Parameters

DataBlockObject [in]

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

FileHandle [in]

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

InstanceName [out]

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.

See also

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock