Função IoWMIQueryAllDataMultiple (wdm.h)

A rotina IoWMIQueryAllDataMultiple retorna todos os blocos de dados WMI que implementam um de um conjunto de classes WMI.

Sintaxe

NTSTATUS IoWMIQueryAllDataMultiple(
  [in]            PVOID  *DataBlockObjectList,
  [in]            ULONG  ObjectCount,
  [in, out]       PULONG InOutBufferSize,
  [out, optional] PVOID  OutBuffer
);

Parâmetros

[in] DataBlockObjectList

Ponteiro para uma matriz de ponteiros para objetos de bloco de dados WMI. O chamador abre um objeto de bloco de dados para cada classe WMI com a rotina IoWMIOpenBlock . Cada objeto deve ser aberto com o direito de acesso WMIGUID_QUERY.

[in] ObjectCount

Especifica o número de entradas na matriz passadas no parâmetro DataBlockObjectList .

[in, out] InOutBufferSize

Ponteiro para um local de memória que especifica o tamanho do buffer passado no parâmetro OutBuffer . Se a rotina for bem-sucedida, ela atualizará o local de memória para especificar o número de bytes realmente armazenados no OutBuffer. Se a rotina falhar com status código de STATUS_BUFFER_TOO_SMALL, ela retornará o número de bytes necessários para retornar os dados.

[out, optional] OutBuffer

Ponteiro para o buffer em que a rotina retorna os dados WMI. A rotina retorna uma sequência de estruturas de WNODE_ALL_DATA de tamanho variável, uma para cada conjunto de blocos de dados retornados. O membro WnodeHeader.Linkage de cada estrutura WNODE_ALL_DATA contém o deslocamento do início do WNODE_ALL_DATA atual até o início do próximo WNODE_ALL_DATA. O bloco final na cadeia tem WnodeHeader.Linkage definido como zero. OutBuffer deve apontar para um buffer alocado do pool nãopagado.

Retornar valor

A rotina retorna um código NTSTATUS. Os possíveis valores retornados incluem:

Código de retorno	Descrição
STATUS_SUCCESS	A operação foi realizada com êxito. A rotina retorna os dados WMI no buffer apontado pelo parâmetro OutBuffer . A rotina também retorna o tamanho, em bytes, dos dados retornados no local da memória apontado pelo parâmetro InOutBufferSize .
STATUS_BUFFER_TOO_SMALL	O buffer passado pelo chamador no parâmetro OutBuffer é muito pequeno. A rotina retorna o tamanho do buffer necessário no local de memória apontado pelo parâmetro InOutBufferSize .

Comentários

IoWMIQueryAllDataMultiple determina quais drivers dão suporte às classes WMI especificadas e emite uma solicitação de IRP_MN_QUERY_ALL_DATA para cada driver desse tipo.

Se nenhum driver implementar nenhuma das classes WMI especificadas, a rotina retornará STATUS_SUCCESS Ela também retornará um valor igual a zero no local de memória apontado pelo parâmetro InOutBufferSize .

Para consultar uma única classe WMI, use IoWMIQueryAllData.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows XP e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Confira também

IRP_MN_QUERY_ALL_DATA

IoWMIOpenBlock

IoWMIQueryAllData