mstask.h) (TASK_TRIGGER 结构

项目
02/29/2024

定义运行计划工作项的时间。

语法

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;

成员

cbTriggerSize

此结构的大小（以字节为单位）。

Reserved1

仅供内部使用;此值必须为零。

wBeginYear

任务触发器激活的年份。此值必须是 1997 (4 位数字，而不是 97) 。设置任务时必须指定开始年份。

wBeginMonth

任务触发器激活的 wBeginYear 成员) 中指定的年份 (月份。设置任务时必须指定起始月份。

wBeginDay

(任务触发器激活的 wBeginMonth 成员) 中指定的月份日期。设置任务时必须指定开始日期。

wEndYear

任务触发器停用的年份。此值必须是 1997 (4 位数字，而不是 97) 。

wEndMonth

任务触发器停用的 wEndYear 成员) 中指定的年份 (月份。

wEndDay

任务触发器停用的 wEndMonth 成员) 中指定的月份日期 (。

wStartHour

任务运行的一天中的小时。此值为 24 小时制;小时从 00 到 23。

wStartMinute

任务运行的 wStartHour 成员) 中指定的小时 (分钟。

MinutesDuration

任务启动后触发器保持活动状态的分钟数。此处指定的分钟数必须大于或等于 MinutesInterval 设置。

例如，如果在上午 8：00 开始任务，并且想要在下午 5：00 之前重复启动任务，则持续时间为 540 分钟。

MinutesInterval

连续执行任务之间的分钟数。此数字从上一个计划任务开始算起。此处指定的分钟数必须小于 MinutesDuration 设置。

例如，若要从上午 8：00 到下午 5：00 每小时运行一个任务，请将此字段设置为 60。

rgFlags

描述触发器行为的值。此值是以下标志的组合。

TASK_TRIGGER_FLAG_HAS_END_DATE

触发器结构的结束日期有效。如果未设置此标志，则忽略结束日期数据，并且触发器将无限期有效。

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

任务将在活动触发器的生存期结束时终止。持续时间结束时，任务计划程序会将WM_CLOSE消息发送到关联的应用程序。例如，如果 (无法发送WM_CLOSE，应用程序没有窗口) 或应用程序在接收WM_CLOSE后的三分钟内未退出，则任务计划程序将使用 TerminateProcess 终止应用程序。

TASK_TRIGGER_FLAG_DISABLED

任务触发器处于非活动状态。

TriggerType

一个TASK_TRIGGER_TYPE枚举值，该值指定触发器的类型。此成员与 Type 一起使用。此处指定的触发器类型确定将使用 Type 成员中指定的TRIGGER_TYPE_UNION的哪些字段。触发器类型基于触发器何时运行任务。

Type

一个 TRIGGER_TYPE_UNION 结构，用于指定有关触发器的详细信息。请注意， TriggerType 成员确定将使用TRIGGER_TYPE_UNION联合的哪些字段。

Reserved2

仅供内部使用;此值必须为零。

wRandomMinutesInterval

当前未使用。

注解

这些时间可能包括工作项的开始时间、结束时间、持续时间和修改标志。请注意，设置触发器时，必须设置开始的月份和年份。

注意计划的工作项可以定义一个或多个触发器。工作项的运行时间是为该项定义的所有触发器的并集。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	mstask.h