Función PdhGetDataSourceTimeRangeH (pdh.h)

Artículo
03/01/2024

Determina el intervalo de tiempo, el número de entradas y, si procede, el tamaño del búfer que contiene los datos de rendimiento del origen de entrada especificado.

Esta función es idéntica a la función PdhGetDataSourceTimeRange , salvo que admite el uso de identificadores para orígenes de datos.

Sintaxis

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

Parámetros

[in] hDataSource

Controle un origen de datos devuelto por la función PdhBindInputDataSource .

[out] pdwNumEntries

Número de estructuras en el búfer de pInfo . Esta función recopila información solo para un intervalo de tiempo, por lo que el valor suele ser 1 o cero si se produjo un error.

[out] pInfo

Estructura PDH_TIME_INFO que recibe el intervalo de tiempo. La información abarca todos los archivos de registro enlazados.

[in] pdwBufferSize

Tamaño de la estructura PDH_TIME_INFO , en bytes.

Valor devuelto

Si la función se ejecuta correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto	Descripción
PDH_INVALID_ARGUMENT	Un parámetro no es válido o tiene un formato incorrecto.
PDH_INVALID_HANDLE	El identificador de contador no es válido.
PDH_DATA_SOURCE_IS_REAL_TIME	El origen de datos actual es un origen de datos en tiempo real.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	pdh.h
Library	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PdhBindInputDataSource

Share via