Función PdhSetQueryTimeRange (pdh.h)

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