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
STATUS_SUCCESS	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 .
STATUS_BUFFER_TOO_SMALL	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

Consulte también

IRP_MN_QUERY_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleInstance

UNICODE_STRING