Función IoWMIHandleToInstanceName (wdm.h)

Artículo
07/02/2025

La rutina IoWMIHandleToInstanceName determina el nombre de instancia de la instancia de clase WMI implementada por el controlador especificado por un identificador de archivo.

Sintaxis

C++

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

Parámetros

[in] DataBlockObject

Puntero a un objeto de bloque de datos WMI. El autor de la llamada abre el objeto de bloque de datos para la clase WMI con la rutina IoWMIOpenBlock.

[in] FileHandle

Especifica un identificador de archivo. La rutina devuelve el nombre de instancia correspondiente al controlador representado por el identificador de archivo.

[out] InstanceName

Puntero a la estructura UNICODE_STRING que usa la rutina para devolver el nombre de la instancia. El autor de la llamada libera el búfer devuelto en UNICODE_STRING.

Valor devuelto

La rutina devuelve un código NTSTATUS. Entre los posibles valores devueltos se incluyen:

Código devuelto	Descripción
STATUS_SUCCESS	La operación se realizó correctamente. La rutina rellena la estructura de UNICODE_STRING a la que apunta el parámetro InstanceName con el nombre de instancia.
STATUS_WMI_INSTANCE_NOT_FOUND	El controlador no implementa ninguna instancia de la clase WMI especificada por DataBlockObject.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Windows XP y versiones posteriores del sistema operativo Windows.
de la plataforma de destino de	Universal
encabezado de	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe
irQL	<= APC_LEVEL