Compartilhar via

Função PdhSetQueryTimeRange (pdh.h)

  • Artigo

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