estructura TASK_TRIGGER (mstask.h)

Artículo
02/29/2024

Define las horas para ejecutar un elemento de trabajo programado.

Sintaxis

typedef struct _TASK_TRIGGER {
  WORD               cbTriggerSize;
  WORD               Reserved1;
  WORD               wBeginYear;
  WORD               wBeginMonth;
  WORD               wBeginDay;
  WORD               wEndYear;
  WORD               wEndMonth;
  WORD               wEndDay;
  WORD               wStartHour;
  WORD               wStartMinute;
  DWORD              MinutesDuration;
  DWORD              MinutesInterval;
  DWORD              rgFlags;
  TASK_TRIGGER_TYPE  TriggerType;
  TRIGGER_TYPE_UNION Type;
  WORD               Reserved2;
  WORD               wRandomMinutesInterval;
} TASK_TRIGGER, *PTASK_TRIGGER;

Miembros

cbTriggerSize

Tamaño de esta estructura, en bytes.

Reserved1

Solo para uso interno; este valor debe ser cero.

wBeginYear

Año en el que se activa la tarea. Este valor debe ser de cuatro dígitos (1997, no 97). El año inicial debe especificarse al establecer una tarea.

wBeginMonth

Mes del año (especificado en el miembro wBeginYear ) que activa el desencadenador de tarea. El mes inicial debe especificarse al establecer una tarea.

wBeginDay

Día del mes (especificado en el miembro wBeginMonth ) que activa el desencadenador de tarea. El día inicial debe especificarse al establecer una tarea.

wEndYear

Año en el que se desactiva el desencadenador de la tarea. Este valor debe ser de cuatro dígitos (1997, no 97).

wEndMonth

Mes del año (especificado en el miembro wEndYear ) que desactiva el desencadenador de tarea.

wEndDay

Día del mes (especificado en el miembro wEndMonth ) que desactiva el desencadenador de tarea.

wStartHour

Hora del día en que se ejecuta la tarea. Este valor está en un reloj de 24 horas; las horas van de 00 a 23.

wStartMinute

Minuto de la hora (especificado en el miembro wStartHour ) que se ejecuta la tarea.

MinutesDuration

Número de minutos después de que se inicie la tarea que el desencadenador permanecerá activo. El número de minutos especificado aquí debe ser mayor o igual que el valor minutesInterval .

Por ejemplo, si inicia una tarea a las 8:00 a.m. y desea iniciar repetidamente la tarea hasta las 5:00 p.m., habrá 540 minutos en la duración.

MinutesInterval

Número de minutos entre ejecuciones de tareas consecutivas. Este número se cuenta desde el inicio de la tarea programada anterior. El número de minutos especificado aquí debe ser menor que el valor MinutesDuration .

Por ejemplo, para ejecutar una tarea cada hora de 8:00 a.m. a 5:00 p.m., establezca este campo en 60.

rgFlags

Valor que describe el comportamiento del desencadenador. Este valor es una combinación de las marcas siguientes.

TASK_TRIGGER_FLAG_HAS_END_DATE

La fecha de finalización de la estructura del desencadenador es válida. Si no se establece esta marca, se omiten los datos de fecha de finalización y el desencadenador será válido indefinidamente.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

La tarea se finalizará al final de la duración del desencadenador activo. Al final de la duración, el Programador de tareas envía un mensaje WM_CLOSE a la aplicación asociada. Si no se puede enviar WM_CLOSE (por ejemplo, la aplicación no tiene ventanas) o la aplicación no ha salido en un plazo de tres minutos después de la WM_CLOSE receptora, el Programador de tareas finaliza la aplicación mediante TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

El desencadenador de tareas está inactivo.

TriggerType

Valor enumerado TASK_TRIGGER_TYPE que especifica el tipo de desencadenador. Este miembro se usa con Type. El tipo de desencadenador especificado aquí determina qué campos del TRIGGER_TYPE_UNION especificado en el miembro Type se usarán. El tipo de desencadenador se basa en cuándo el desencadenador ejecutará la tarea.

Type

Estructura TRIGGER_TYPE_UNION que especifica detalles sobre el desencadenador. Tenga en cuenta que el miembro TriggerType determina qué campos de la unión de TRIGGER_TYPE_UNION se usarán.

Reserved2

Solo para uso interno; este valor debe ser cero.

wRandomMinutesInterval

No se usa actualmente.

Comentarios

Estas horas pueden incluir la hora de inicio, la hora de finalización, la duración y las marcas de modificación del elemento de trabajo. Tenga en cuenta que al establecer un desencadenador, se debe establecer el mes y el año de comienzo del día.

Nota Un elemento de trabajo programado puede tener uno o varios desencadenadores definidos. Las veces que se ejecutará el elemento de trabajo son la unión de todos los desencadenadores definidos para ese elemento.

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