Compartir a través de

Función PdhGetDataSourceTimeRangeA (pdh.h)

  • Artículo

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.

Para usar identificadores para orígenes de datos, use la función PdhGetDataSourceTimeRangeH .

Sintaxis

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Parámetros

[in] szDataSource

Cadena terminada en NULL que especifica el nombre de un archivo de registro desde el que se recupera la información del intervalo de tiempo.

[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.

[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.

Comentarios

Nota

El encabezado pdh.h define PdhGetDataSourceTimeRange como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange