Función IoWMIHandleToInstanceName (wdm.h)
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
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 la rutina usa para devolver el nombre de 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 valores devueltos posibles se incluyen:
| Código devuelto | Descripción |
|---|---|
|
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. |
|
El controlador no implementa ninguna instancia de la clase WMI especificada por DataBlockObject. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores del sistema operativo Windows. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |