Função PdhSetQueryTimeRange (pdh.h)

Limita os exemplos que você pode ler de um arquivo de log para aqueles dentro do intervalo de tempo especificado, inclusive.

Sintaxe

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

Parâmetros

[in] hQuery

Manipule para a consulta. A função PdhOpenQuery retorna esse identificador.

[in] pInfo

Uma estrutura PDH_TIME_INFO que especifica o intervalo de tempo. Especifique a hora como hora do arquivo local. A hora de término deve ser maior que a hora de início. Você pode especificar 0 para a hora de início e o valor máximo de 64 bits para a hora de término se quiser ler todos os registros.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será 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_INVALID_ARGUMENT	O valor do intervalo de tempo final deve ser maior que o valor do intervalo de tempo inicial.

Comentários

Quando o final do intervalo de tempo especificado ou o final do arquivo de log for atingido, a função PdhCollectQueryData retornará PDH_NO_MORE_DATA.

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

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery