Función IoWMIQuerySingleInstanceMultiple (wdm.h)
La rutina IoWMIQuerySingleInstanceMultiple devuelve todas las instancias de bloque de datos WMI que implementan las clases WMI especificadas con los nombres de instancia especificados.
Sintaxis
NTSTATUS IoWMIQuerySingleInstanceMultiple(
[in] PVOID *DataBlockObjectList,
[in] PUNICODE_STRING InstanceNames,
[in] ULONG ObjectCount,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
Parámetros
[in] DataBlockObjectList
Puntero a una matriz de punteros de objetos de bloque de datos WMI. El autor de la llamada abre un objeto de bloque de datos para cada clase WMI con la rutina IoWMIOpenBlock . Cada objeto debe abrirse con el derecho de acceso WMIGUID_QUERY.
[in] InstanceNames
Puntero a una matriz de estructuras de UNICODE_STRING que contienen nombres de instancia. El nombre de instancia nºde la matriz corresponde al valor de la propiedad InstanceName de la nªclase WMI especificada en la matriz a la que apunta el parámetro DataBlockObjectList .
[in] ObjectCount
Especifica el número de entradas de las matrices pasadas en los parámetros DataBlockObjectList e InstanceNames .
[in, out] InOutBufferSize
Puntero a una ubicación de memoria que especifica el tamaño del búfer pasado en el parámetro OutBuffer . Si la rutina se realiza correctamente, actualiza la ubicación de memoria para especificar el número de bytes almacenados realmente en OutBuffer. Si se produce un error en la rutina con STATUS_BUFFER_TOO_SMALL, devuelve el número de bytes necesarios para devolver los datos.
[out, optional] OutBuffer
Puntero al búfer donde la rutina devuelve los datos WMI. La rutina devuelve una secuencia de estructuras de WNODE_SINGLE_INSTANCE de tamaño variable, una para cada instancia de bloque de datos. El miembro WnodeHeader.Linkage de cada estructura de WNODE_SINGLE_INSTANCE contiene el desplazamiento desde el principio del WNODE_SINGLE_INSTANCE actual hasta el principio del siguiente WNODE_SINGLE_INSTANCE. El bloque final de la cadena tiene WnodeHeader.Linkage establecido en cero. Cada instancia de bloque de datos distinta corresponde a una única clase WMI y un nombre de instancia coincidentes. OutBuffer debe apuntar a un búfer asignado desde un grupo no paginado.
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 devuelve los datos WMI del búfer al que apunta el parámetro OutBuffer . La rutina también devuelve el tamaño, en bytes, de los datos devueltos en la ubicación de memoria a la que apunta el parámetro InOutBufferSize . |
|
El búfer pasado por el autor de la llamada en el parámetro OutBuffer es demasiado pequeño. La rutina devuelve el tamaño de búfer necesario en la ubicación de memoria a la que apunta el parámetro InOutBufferSize . |
Comentarios
IoWMIQuerySingleInstanceMultiple determina qué controladores pueden admitir las clases WMI y los nombres de instancia especificados, y emite una solicitud de IRP_MN_QUERY_SINGLE_INSTANCE a cada controlador de este tipo. Cada controlador que exporta la instancia de bloque de datos con la propiedad InstanceName coincidente devuelve los datos adecuados.
Si ningún controlador implementa ninguna de las clases WMI y los nombres de instancia especificados, la rutina devuelve STATUS_SUCCESS. También devuelve un valor de cero en la ubicación de memoria a la que apunta el parámetro InOutBufferSize .
Para consultar una sola clase WMI y un nombre de instancia, use la rutina IoWMIQuerySingleInstance . Los controladores pueden usar la rutina IoWMISetSingleInstance para actualizar una instancia de clase.
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 |