Share via

Método IScheduledWorkItem::GetStatus (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 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
S_OK
 La operación se realizó correctamente. Se envió la solicitud. Para obtener más información, vea la sección Comentarios.
E_INVALIDARG
 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

Consulte también

IScheduledWorkItem

ITask