Função PdhGetDataSourceTimeRangeH (pdh.h)

Artigo
03/01/2024

Determina o intervalo de tempo, o número de entradas e, se aplicável, o tamanho do buffer que contém os dados de desempenho da fonte de entrada especificada.

Essa função é idêntica à função PdhGetDataSourceTimeRange , exceto que ela dá suporte ao uso de identificadores para fontes de dados.

Sintaxe

PDH_FUNCTION PdhGetDataSourceTimeRangeH(
  [in]  PDH_HLOG       hDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parâmetros

[in] hDataSource

Manipule para uma fonte de dados retornada pela função PdhBindInputDataSource .

[out] pdwNumEntries

Número de estruturas no buffer pInfo . Essa função coleta informações para apenas um intervalo de tempo, portanto, o valor normalmente é 1 ou zero se ocorreu um erro.

[out] pInfo

Uma estrutura PDH_TIME_INFO que recebe o intervalo de tempo. As informações abrangem todos os arquivos de log associados.

[in] pdwBufferSize

Tamanho da estrutura PDH_TIME_INFO , em bytes.

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_ARGUMENT	Um parâmetro não é válido ou está formatado incorretamente.
PDH_INVALID_HANDLE	O identificador do contador não é válido.
PDH_DATA_SOURCE_IS_REAL_TIME	A fonte de dados atual é uma fonte de dados em tempo real.

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

PdhBindInputDataSource

Compartilhar via