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 |
|---|---|
|
O identificador de consulta não é válido. |
|
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 |