Método IScheduledWorkItem::GetRunTimes (mstask.h)
[[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 |
---|---|
|
Se recuperó el número solicitado de tiempos de ejecución. |
|
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. |
|
El elemento de trabajo está habilitado, pero no tiene desencadenadores válidos. |
|
El elemento de trabajo está deshabilitado. |
|
Uno o varios argumentos no son válidos. |
|
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 |