Método IScheduledWorkItem::GetRunTimes (mstask.h)

  • Artículo

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o producto. Use en su lugar las interfaces del Programador de tareas 2.0 . ]

Recupera los tiempos de ejecución del elemento de trabajo durante un período de tiempo especificado.

Sintaxis

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

Parámetros

[in] pstBegin

Puntero a una estructura SYSTEMTIME que contiene la hora de inicio del período de tiempo que se va a comprobar. Este valor es inclusivo.

[in] pstEnd

Puntero a una estructura SYSTEMTIME que contiene la hora de finalización del período de tiempo que se va a comprobar. Este valor es exclusivo. Si se pasa NULL para este valor, la hora de finalización es infinita.

[in, out] pCount

Puntero a un valor DE WORD que especifica el número de tiempos de ejecución que se van a recuperar.

En la entrada, este parámetro contiene el número de tiempos de ejecución que se solicitan. Puede ser un número de entre 1 y TASK_MAX_RUN_TIMES.

En la salida, este parámetro contiene el número de tiempos de ejecución recuperados.

[out] rgstTaskTimes

Puntero a una matriz de estructuras SYSTEMTIME . Un objeto LPSYSTEMTIME NULL debe pasarse a este parámetro. A la devolución, esta matriz contiene tiempos de ejecución de pCount . Debe liberar esta matriz mediante una llamada a la función CoTaskMemFree .

Valor devuelto

El método GetRunTimes devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 Se recuperó el número solicitado de tiempos de ejecución.
S_FALSE
 El método se realizó correctamente, pero se recuperó menos del número solicitado de tiempos de ejecución. El número de tiempos de ejecución recuperados se encuentra en el valor al que apunta pCount. Si el número de tiempos de ejecución recuperados es cero, tampoco hay desencadenadores basados en eventos que puedan hacer que el elemento de trabajo se ejecute durante el período de tiempo especificado.
SCHED_S_TASK_NO_VALID_TRIGGERS
 El elemento de trabajo está habilitado, pero no tiene desencadenadores válidos.
SCHED_S_TASK_DISABLED
 El elemento de trabajo está deshabilitado.
E_INVALIDARG
 Uno o varios argumentos no son válidos.
E_OUTOFMEMORY
 No hay memoria suficiente para calcular el resultado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mstask.h
Library Mstask.lib
Archivo DLL Mstask.dll
Redistribuible Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95

Consulte también

IScheduledWorkItem