Função PdhCollectQueryData (pdh.h)

Coleta o valor de dados brutos atual para todos os contadores na consulta especificada e atualiza o código status de cada contador.

Sintaxe

PDH_FUNCTION PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

Parâmetros

[in, out] hQuery

Identificador da consulta para a qual você deseja coletar dados. A função PdhOpenQuery retorna esse identificador.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro do sistema ou um código de erro PDH.

Veja a seguir os valores possíveis.

Código de retorno	Descrição
PDH_INVALID_HANDLE	O identificador de consulta não é válido.
PDH_NO_DATA	No momento, a consulta não contém contadores. A consulta pode não conter dados porque o usuário não está em execução com um token com privilégios elevados (consulte Suporte limitado ao acesso do usuário).

Comentários

Chame essa função quando quiser coletar dados de contador para os contadores na consulta. O PDH armazena os valores brutos do contador para a coleção atual e anterior.

Se você quiser recuperar o valor do contador bruto atual, chame a função PdhGetRawCounterValue . Se você quiser calcular um valor exibivel para o valor do contador, chame a função PdhGetFormattedCounterValue . Se o caminho do contador contiver um curinga para o nome da instância, chame as funções PdhGetRawCounterArray e PdhGetFormattedCounterArray , respectivamente.

Quando PdhCollectQueryData é chamado para dados apenas de uma instância de contador e a instância do contador não existe, a função retorna PDH_NO_DATA. No entanto, se dados de mais de um contador forem consultados, PdhCollectQueryData poderá retornar ERROR_SUCCESS mesmo que uma das instâncias de contador ainda não exista. Isso ocorre porque não se sabe se a instância do contador especificada não existe ou se ela existirá, mas ainda não foi criada. Nesse caso, chame PdhGetRawCounterValue ou PdhGetFormattedCounterValue para cada uma das instâncias de interesse do contador para determinar se elas existem.

A seguir, mostra a sintaxe ao chamar essa função do Visual Basic.

PdhCollectQueryData(
  ByVal QueryHandle as Long  
)
as Long

Exemplos

Para obter um exemplo, consulte Navegando contadores de desempenho ou lendo dados de desempenho de um arquivo de log.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	pdh.h
Biblioteca	Pdh.lib
DLL	Pdh.dll

Confira também

PdhGetFormattedCounterValue

PdhGetRawCounterValue