Compartir a través de


Enumeración TASKPAGE (mstask.h)

[[Esta API puede modificarse o no estar disponible en versiones posteriores del sistema operativo o del producto. Use en su lugar el Programador de tareas 2.0 Tipos enumerados . ]

Define el tipo de página de tareas que se va a recuperar.

Cada página de propiedades se puede usar para definir las propiedades de un objeto de tarea.

Syntax

typedef enum _TASKPAGE {
  TASKPAGE_TASK = 0,
  TASKPAGE_SCHEDULE = 1,
  TASKPAGE_SETTINGS = 2
} TASKPAGE;

Constantes

 
TASKPAGE_TASK
Valor: 0
Especifica la página Tarea de la tarea. En esta página se proporcionan los siguientes elementos de la interfaz de usuario:






  • Ejecutar: este campo especifica el nombre de la aplicación asociada a la tarea.

  • Esta propiedad también se puede establecer mediante programación llamando a
    ITask::SetApplicationName.

  • Iniciar en: este campo especifica el directorio de trabajo de la tarea.

  • Esta propiedad también se puede establecer mediante programación llamando a
    ITask::SetWorkingDirectory.

  • Comentarios: este campo especifica los comentarios definidos por la aplicación para la tarea.

  • Esta propiedad también se puede establecer mediante programación llamando a
    IScheduledWorkItem::SetComment.

  • Ejecutar como: (Solo Windows Server 2003, Windows XP y Windows 2000). Este campo especifica el nombre de la cuenta con el que se ejecutará la tarea. A la derecha de este campo se muestra un botón Contraseña para especificar la contraseña de la cuenta.

  • Esta propiedad también se puede establecer mediante programación llamando a
    IScheduledWorkItem::SetAccountInformation.

  • Habilitado (se ejecuta una tarea programada en un momento específico): esta casilla especifica si se establece la marca de TASK_TRIGGER_FLAG_DISABLED.

  • Esta propiedad también se puede establecer estableciendo esta marca en el miembro rgFlags del
    TASK_TRIGGER estructura.

TASKPAGE_SCHEDULE
Valor: 1
Especifica la página Programación de la tarea. Esta página se usa para administrar los desencadenadores de la tarea. El usuario puede crear desencadenadores, editar desencadenadores y eliminar desencadenadores de esta página.




En esta página se proporcionan los siguientes elementos de la interfaz de usuario:


  • Cuadro de lista desencadenador: este cuadro de lista solo se muestra si existen varios desencadenadores.

  • Tarea de programación: este campo especifica la frecuencia con la que se ejecutará la tarea: diaria, semanal, mensual, una vez, en el inicio del sistema, en el inicio de sesión o cuando está inactiva.

  • Hora de inicio: este campo especifica la hora del día en que se ejecutará la tarea.

  • Avanzado: este botón permite establecer la fecha de inicio y la fecha de finalización para ejecutar la tarea.

  • Cuadro Grupo de tareas de programación: este cuadro de grupo solo se muestra si el campo Tarea de programación especifica diaria, semanal, mensual o una vez.

  • Mostrar varias programaciones: muestra todos los desencadenadores. Cuando se activa, se muestra el cuadro de lista Desencadenador.

TASKPAGE_SETTINGS
Valor: 2
Especifica la página Configuración de la tarea. El usuario puede especificar lo que sucede cuando se completa la tarea, las condiciones de inactividad y las propiedades de administración de energía de la tarea.




En esta página se proporcionan los siguientes elementos de la interfaz de usuario:


  • Cuadro de grupo Tarea programada Completada: esta casilla de grupo incluye casillas para establecer la marca de TASK_FLAG_DELETE_WHEN_DONE y el tiempo de ejecución máximo de la tarea.

  • La marca de TASK_FLAG_DELETE_WHEN_DONE también se puede establecer mediante programación llamando a .
    IScheduledWorkItem::SetFlags. El tiempo de ejecución máximo se puede establecer llamando a .
    ITask::SetMaxRunTime.

  • Cuadro de grupo De tiempo de inactividad: este cuadro de grupo incluye campos para establecer condiciones de inactividad.

  • El tiempo de inactividad también se puede establecer mediante programación llamando a .
    IScheduledWorkItem::SetIdleWait. Las marcas de TASK_FLAG_START_ONLY_IF_IDLE y TASK_FLAG_KILL_ON_IDLE_END se pueden establecer mediante una llamada a
    IScheduledWorkItem::SetFlags.

  • Cuadro de grupo de administración de energía: (solo Windows 95) Esta casilla de grupo incluye casillas para indicar cómo se comporta la tarea cuando el sistema pierde energía.

  • Estas propiedades también se pueden establecer mediante programación estableciendo las marcas de TASK_FLAG_DONT_START_IF_ON_BATTERIES y TASK_FLAG_KILL_IF_GOING_ON_BATTERIES mediante
    IScheduledWorkItem::SetFlags.

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]
Encabezado mstask.h

Consulte también

IProvideTaskPage::GetPage

IScheduledWorkItem::SetAccountInformation

IScheduledWorkItem::SetComment

IScheduledWorkItem::SetFlags

IScheduledWorkItem::SetIdleWait

ITask::SetApplicationName

ITask::SetMaxRunTime

ITask::SetWorkingDirectory

TASK_TRIGGER