Função PdhCollectQueryDataWithTime (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 PdhCollectQueryDataWithTime(
[in, out] PDH_HQUERY hQuery,
[out] LONGLONG *pllTimeStamp
);
Parâmetros
[in, out] hQuery
Identificador da consulta para a qual você deseja coletar dados. A função PdhOpenQuery retorna esse identificador.
[out] pllTimeStamp
Carimbo de data/hora em que o primeiro valor do contador na consulta foi recuperado. A hora é especificada como FILETIME.
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 tem contadores. |
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 pdhGetFormattedCounterValue. Se o caminho do contador contiver um curinga para o nome da instância, chame as funções PdhGetRawCounterArray e PdhGetFormattedCounterArray , respectivamente.
Quando PdhCollectQueryDataEx é chamado apenas para dados 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 os dados de mais de um contador forem consultados, PdhCollectQueryDataEx poderá retornar ERROR_SUCCESS mesmo que uma das instâncias do contador ainda não exista. Isso ocorre porque não se sabe se a instância de contador especificada não existe ou se ela existirá, mas ainda não foi criada. Nesse caso, chame a função PdhGetRawCounterValue ou PdhGetFormattedCounterValue para cada uma das instâncias de contador de interesse para determinar se elas existem.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | pdh.h |
| Biblioteca | Pdh.lib |
| DLL | Pdh.dll |