Trigger Structures for Task Scheduler 1.0

Task Scheduler 1.0 uses several structures to define the criteria of a trigger.

Note  For more information about Task Scheduler 2.0 triggers, see Trigger Interfaces.
 

Task Scheduler 1.0 Structures

The following illustration shows the TASK_TRIGGER structure. It has three required members (wBeginYear, wBeginMonth, and wBeginDay) that must be set when creating a new trigger. (To jump to the reference page for this structure, click the structure name in the illustration.)

Task trigger structure

Be aware that the TriggerType member uses the TASK_TRIGGER_TYPE enumeration and the Type member uses a TASK_TRIGGER_UNION structure. The TASK_TRIGGER_TYPE enumeration is used to specify the type of trigger (event and time-based trigger types). The TRIGGER_TYPE_UNION structure is used to combine the DAILY, WEEKLY, MONTHLYDATE (day of month), and MONTHLYDOW (day of week) structures that are used to specify when a time-based trigger will fire.

If TriggerType specifies a one-time time-based trigger or an event-based trigger, the Type member is ignored. The TRIGGER_TYPE_UNION structure is used only if the TriggerType member specifies a daily, weekly, day-of-month, or monthly day-of-week time-based trigger.

In addition, the setting of the Type member indicates which member of the TRIGGER_TYPE_UNION structure is used. The following illustration shows the relationship between the values of the TASK_TRIGGER_TYPE enumeration and the members of the TRIGGER_TYPE_STRUCTURE structure. (To jump to the reference pages for these structures click the structure name in the illustration.)

Relationship between Task Trigger Type enumeration values and members of the Trigger Type Structure structure

Related topics

Task Triggers
Trigger Types
Trigger Interfaces

 

 

Show: