Función IoWMIQueryAllData (wdm.h)
La rutina IoWMIQueryAllData devuelve todos los bloques de datos WMI que implementan una clase WMI determinada.
Sintaxis
NTSTATUS IoWMIQueryAllData(
[in] PVOID DataBlockObject,
[in, out] PULONG InOutBufferSize,
[out, optional] PVOID OutBuffer
);
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 . El objeto debe abrirse con el derecho de acceso WMIGUID_QUERY.
[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 el código de estado de 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_ALL_DATA de tamaño variable, una para cada conjunto de bloques de datos devueltos. El miembro WnodeHeader.Linkage de cada estructura de WNODE_ALL_DATA contiene el desplazamiento desde el principio del WNODE_ALL_DATA actual hasta el principio del siguiente WNODE_ALL_DATA. El bloque final de la cadena tiene WnodeHeader.Linkage establecido en cero. 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 . |
|
Ningún controlador implementa la clase WMI especificada. |
|
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
IoWMIQueryAllData determina qué controladores admiten la clase WMI especificada y emite una solicitud de IRP_MN_QUERY_ALL_DATA a cada controlador de este tipo.
Para consultar varias clases WMI, use IoWMIQueryAllDataMultiple.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft 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 |