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.

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

Confira também

PdhGetFormattedCounterValue

PdhGetRawCounterValue