Interfaz IScheduledWorkItem (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 . ]
Proporciona los métodos para administrar elementos de trabajo específicos.
Herencia
La interfaz IScheduledWorkItem hereda de la interfaz IUnknown . IScheduledWorkItem también tiene estos tipos de miembros:
Métodos
La interfaz IScheduledWorkItem tiene estos métodos.
| IScheduledWorkItem::CreateTrigger Crea un desencadenador para el elemento de trabajo. |
| IScheduledWorkItem::D eleteTrigger Elimina un desencadenador de un elemento de trabajo. |
| IScheduledWorkItem::EditWorkItem Muestra las páginas de propiedades Tarea, Programación y configuración del elemento de trabajo, lo que permite al usuario establecer las propiedades en esas páginas. |
| IScheduledWorkItem::GetAccountInformation Recupera el nombre de la cuenta del elemento de trabajo. |
| IScheduledWorkItem::GetComment Recupera el comentario del elemento de trabajo. |
| IScheduledWorkItem::GetCreator Recupera el nombre del creador del elemento de trabajo. |
| IScheduledWorkItem::GetErrorRetryCount Recupera el número de veces que el Programador de tareas reintentará una operación cuando se produzca un error. Este método no se implementa. |
| IScheduledWorkItem::GetErrorRetryInterval Recupera el intervalo de tiempo, en minutos, entre los intentos del Programador de tareas de ejecutar un elemento de trabajo si se produce un error. Este método no se implementa. |
| IScheduledWorkItem::GetExitCode Recupera el último código de salida devuelto por el ejecutable asociado al elemento de trabajo en su última ejecución. El método también devuelve el código de salida devuelto al Programador de tareas cuando intentó ejecutar el elemento de trabajo por última vez. |
| IScheduledWorkItem::GetFlags Recupera las marcas que modifican el comportamiento de cualquier tipo de elemento de trabajo. |
| IScheduledWorkItem::GetIdleWait Recupera el tiempo de espera de inactividad del elemento de trabajo. |
| IScheduledWorkItem::GetMostRecentRunTime Recupera la hora más reciente en que comenzó a ejecutarse el elemento de trabajo. |
| IScheduledWorkItem::GetNextRunTime Recupera la próxima vez que se ejecute el elemento de trabajo. |
| IScheduledWorkItem::GetRunTimes Recupera los tiempos de ejecución del elemento de trabajo durante un período de tiempo especificado. |
| IScheduledWorkItem::GetStatus Recupera el estado del elemento de trabajo. |
| IScheduledWorkItem::GetTrigger Recupera un desencadenador de tarea. |
| IScheduledWorkItem::GetTriggerCount Recupera el número de desencadenadores para el elemento de trabajo actual. |
| IScheduledWorkItem::GetTriggerString Recupera una cadena que describe el desencadenador del elemento de trabajo. |
| IScheduledWorkItem::GetWorkItemData Recupera los datos definidos por la aplicación asociados al elemento de trabajo. |
| IScheduledWorkItem::Run Envía una solicitud al servicio Programador de tareas para ejecutar el elemento de trabajo. |
| IScheduledWorkItem::SetAccountInformation Establece el nombre de cuenta y la contraseña usados para ejecutar el elemento de trabajo. |
| IScheduledWorkItem::SetComment Establece el comentario del elemento de trabajo. |
| IScheduledWorkItem::SetCreator Establece el nombre del creador del elemento de trabajo. |
| IScheduledWorkItem::SetErrorRetryCount Establece el número de veces que el Programador de tareas intentará volver a ejecutar el elemento de trabajo si se produce un error. Este método no se implementa. |
| IScheduledWorkItem::SetErrorRetryInterval Establece el intervalo de tiempo, en minutos, entre los intentos del Programador de tareas de ejecutar un elemento de trabajo después de que se produzca un error. Este método no se implementa. |
| IScheduledWorkItem::SetFlags Establece las marcas que modifican el comportamiento de cualquier tipo de elemento de trabajo. |
| IScheduledWorkItem::SetIdleWait Establece los minutos que el sistema debe estar inactivo antes de que se pueda ejecutar el elemento de trabajo. |
| IScheduledWorkItem::SetWorkItemData Este método almacena los datos definidos por la aplicación asociados al elemento de trabajo. |
| IScheduledWorkItem::Terminate Este método finaliza la ejecución del elemento de trabajo. |
Comentarios
La interfaz IScheduledWorkItem es la interfaz base de la interfaz ITask . La interfaz ITask hereda todos los métodos proporcionados por IScheduledWorkItem y normalmente se llama a través de esa interfaz.
Ejemplos
Para obtener más información y código de ejemplo para esta interfaz, vea Ejemplo de código de C/C++: 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 |
| Redistribuible | Internet Explorer 4.0 o posterior en Windows NT 4.0 y Windows 95 |