TASK_TRIGGER 結構 (mstask.h)

發行項
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 (四位數，而不是 97) 。設定工作時，必須指定開始年份。

wBeginMonth

在工作觸發程式啟動的 wBeginYear 成員) 中指定的年份月份 (。設定工作時，必須指定開始月份。

wBeginDay

在工作觸發程式啟動的 wBeginMonth 成員) 中指定的月份日期 (。設定工作時，必須指定開始日。

wEndYear

工作觸發程式停用的年份。此值必須是 1997 (四位數，而不是 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	mstask.h