Compartir a través de

Función PdhSetQueryTimeRange (pdh.h)

  • Artículo

Limita los ejemplos que puede leer de un archivo de registro a los que se encuentran dentro del intervalo de tiempo especificado, de forma inclusiva.

Sintaxis

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

Parámetros

[in] hQuery

Identificador de la consulta. La función PdhOpenQuery devuelve este identificador.

[in] pInfo

Estructura PDH_TIME_INFO que especifica el intervalo de tiempo. Especifique la hora como hora de archivo local. La hora de finalización debe ser mayor que la hora de inicio. Puede especificar 0 para la hora de inicio y el valor máximo de 64 bits para la hora de finalización si desea leer todos los registros.

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_HANDLE
 El identificador de consulta no es válido.
PDH_INVALID_ARGUMENT
 El valor del intervalo de tiempo final debe ser mayor que el valor del intervalo de tiempo inicial.

Comentarios

Cuando se alcanza el final del intervalo de tiempo especificado o el final del archivo de registro, la función PdhCollectQueryData devolverá PDH_NO_MORE_DATA.

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

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery