Função IoWMIQueryAllData (wdm.h)

Artigo
02/07/2025

A rotina de IoWMIQueryAllData retorna todos os blocos de dados WMI que implementam uma determinada classe WMI.

Sintaxe

NTSTATUS IoWMIQueryAllData(
  [in]            PVOID  DataBlockObject,
  [in, out]       PULONG InOutBufferSize,
  [out, optional] PVOID  OutBuffer
);

Parâmetros

[in] DataBlockObject

Ponteiro para um objeto de bloco de dados WMI. O chamador abre o objeto de bloco de dados da classe WMI com a rotina de IoWMIOpenBlock. O objeto deve ser aberto com o WMIGUID_QUERY direito de acesso.

[in, out] InOutBufferSize

Ponteiro para um local de memória que especifica o tamanho do buffer passado no parâmetro do OutBuffer. Se a rotina for bem-sucedida, ela atualizará o local de memória para especificar o número de bytes realmente armazenados em outbuffer. Se a rotina falhar com o código de status 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 do 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 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 da cadeia WnodeHeader.Linkage definido como zero. do OutBuffer deve apontar para um buffer alocado do pool nãopagado.

Valor de retorno

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

Código de retorno	Descrição
STATUS_SUCCESS	A operação foi bem-sucedida. 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_WMI_GUID_NOT_FOUND	Nenhum drivers implementa a classe WMI especificada.
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.

Observações

IoWMIQueryAllData determina quais drivers dão suporte à classe WMI especificada e emite uma solicitação IRP_MN_QUERY_ALL_DATA a cada driver.

Para consultar várias classes WMI, use IoWMIQueryAllDataMultiple.

Requisitos

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

Consulte também

IRP_MN_QUERY_ALL_DATA

IoWMIOpenBlock

IoWMIQueryAllDataMultiple

Compartilhar via