Método IScheduledWorkItem::GetStatus (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 el estado del elemento de trabajo.
Sintaxis
HRESULT GetStatus(
[out] HRESULT *phrStatus
);
Parámetros
[out] phrStatus
Puntero a un valor HRESULT que contiene uno de los valores siguientes al devolver.
SCHED_S_TASK_READY
El elemento de trabajo está listo para ejecutarse a la próxima hora programada.
SCHED_S_TASK_RUNNING
El elemento de trabajo se está ejecutando actualmente.
SCHED_S_TASK_NOT_SCHEDULED
No se han establecido una o varias de las propiedades necesarias para ejecutar esta tarea según una programación.
SCHED_S_TASK_HAS_NOT_RUN
No se ha ejecutado la tarea. Este valor se devuelve siempre que la tarea no se haya ejecutado, incluso si la tarea está lista para ejecutarse en la próxima hora programada o la tarea es una tarea periódica.
SCHED_S_TASK_DISABLED
La tarea no se ejecutará en las horas programadas porque se ha deshabilitado.
SCHED_S_TASK_NO_MORE_RUNS
No hay más ejecuciones programadas para esta tarea.
SCHED_S_TASK_NO_VALID_TRIGGERS
La tarea no tiene desencadenadores o los desencadenadores existentes están deshabilitados o no están establecidos.
Valor devuelto
El método GetStatus devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. Se envió la solicitud. Para obtener más información, vea la sección Comentarios. |
|
Los argumentos no son válidos. |
Comentarios
La interfaz IScheduledWorkItem hereda los métodos de la interfaz IScheduledWorkItem. Por lo tanto, normalmente se llama a IScheduledWorkItem::GetStatus a través de la interfaz ITask .
IScheduledWorkItem::GetStatus no obtiene el estado de la tarea dinámicamente. Se debe llamar a ITaskScheduler::Activate para obtener una nueva interfaz IScheduledWorkItem, que se usa para obtener un estado actualizado. Para obtener más información, vea el ejemplo de ITaskScheduler::Activate.
Ejemplos
Para obtener un ejemplo de cómo recuperar el estado de una tarea, vea Ejemplo de código de C/C++: Recuperación del estado de la tarea.
Para obtener un ejemplo de cómo recuperar el estado de la tarea como parte de la terminación de la tarea, vea Ejemplo de terminación de una tarea.
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 |