Método IRegisteredTask::GetRunTimes (taskschd.h)

  • Artículo

Obtiene las horas en que se programa la tarea registrada para ejecutarse durante un tiempo especificado.

Sintaxis

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstStart,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] DWORD              *pCount,
  [out]     LPSYSTEMTIME       *pRunTimes
);

Parámetros

[in] pstStart

Hora de inicio de la consulta.

[in] pstEnd

Hora de finalización de la consulta.

[in, out] pCount

Número solicitado de ejecuciones en la entrada y el número devuelto de ejecuciones en la salida.

[out] pRunTimes

Horas programadas en las que se ejecutará la tarea. Se debe pasar un objeto LPSYSTEMTIME NULL a este parámetro. A cambio, esta matriz contiene tiempos de ejecución de pCount . Debe liberar esta matriz mediante una llamada a la función CoTaskMemFree .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si el método devuelve S_FALSE, el parámetro pRunTimes contiene elementos pCount, pero había más ejecuciones de la tarea, que no se devolvieron. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

Si la tarea registrada contiene desencadenadores que están deshabilitados individualmente, estos desencadenadores seguirán afectando al siguiente tiempo de ejecución programado que se devuelve aunque estén deshabilitados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado taskschd.h
Library Taskschd.lib
Archivo DLL Taskschd.dll

Consulte también

IRegisteredTask

Programador de tareas