TASK_TRIGGER-Struktur (mstask.h)

Artikel
03/04/2024

Definiert die Zeiten zum Ausführen eines geplanten Arbeitselements.

Syntax

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;

Member

cbTriggerSize

Größe dieser Struktur in Bytes.

Reserved1

Nur für den internen Gebrauch; dieser Wert muss 0 sein.

wBeginYear

Jahr, in dem der Tasktrigger aktiviert wird. Dieser Wert muss vier Ziffern (1997, nicht 97) sein. Beim Festlegen einer Aufgabe muss das Anfangsjahr angegeben werden.

wBeginMonth

Monat des Jahres (angegeben im wBeginYear-Member ), den der Tasktrigger aktiviert. Beim Festlegen einer Aufgabe muss der Anfangsmonat angegeben werden.

wBeginDay

Tag des Monats (angegeben im wBeginMonth-Element ), den der Tasktrigger aktiviert. Beim Festlegen einer Aufgabe muss der Anfangstag angegeben werden.

wEndYear

Jahr, das der Tasktrigger deaktiviert. Dieser Wert muss vier Ziffern (1997, nicht 97) sein.

wEndMonth

Monat des Jahres (angegeben im wEndYear-Member ), den der Tasktrigger deaktiviert.

wEndDay

Tag des Monats (angegeben im wEndMonth-Element ), den der Tasktrigger deaktiviert.

wStartHour

Stunde des Tages, in dem der Task ausgeführt wird. Dieser Wert ist auf einer 24-Stunden-Uhr; Stunden gehen von 00 auf 23.

wStartMinute

Minute der Stunde (angegeben im wStartHour-Member ), die der Task ausführt.

MinutesDuration

Anzahl der Minuten nach dem Starten des Tasks, die der Trigger aktiv bleibt. Die hier angegebene Anzahl von Minuten muss größer oder gleich der Einstellung MinutesInterval sein.

Wenn Sie beispielsweise eine Aufgabe um 8:00 Uhr starten und den Vorgang wiederholt bis 17:00 Uhr starten möchten, beträgt die Dauer 540 Minuten.

MinutesInterval

Anzahl der Minuten zwischen aufeinanderfolgenden Aufgabenausführungen. Diese Zahl wird ab dem Beginn der vorherigen geplanten Aufgabe gezählt. Die hier angegebene Anzahl von Minuten muss kleiner als die Einstellung MinutesDuration sein.

Wenn Sie beispielsweise stündlich einen Task von 8:00 Uhr bis 17:00 Uhr ausführen möchten, legen Sie dieses Feld auf 60 fest.

rgFlags

Wert, der das Verhalten des Triggers beschreibt. Dieser Wert ist eine Kombination der folgenden Flags.

TASK_TRIGGER_FLAG_HAS_END_DATE

Das Enddatum der Triggerstruktur ist gültig. Wenn dieses Flag nicht festgelegt ist, werden die Enddatumsdaten ignoriert, und der Trigger ist unbegrenzt gültig.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

Der Task wird am Ende der Lebensdauer des aktiven Triggers beendet. Am Ende der Dauer sendet der Taskplaner eine WM_CLOSE Nachricht an die zugehörige Anwendung. Wenn WM_CLOSE nicht gesendet werden kann (z. B. die Anwendung verfügt über keine Fenster) oder die Anwendung nicht innerhalb von drei Minuten nach dem empfangenden WM_CLOSE beendet wurde, beendet der Taskplaner die Anwendung mithilfe von TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

Der Tasktrigger ist inaktiv.

TriggerType

Ein TASK_TRIGGER_TYPE aufgezählten Wert, der den Typ des Triggers angibt. Dieses Element wird mit Type verwendet. Der hier angegebene Triggertyp bestimmt, welche Felder der TRIGGER_TYPE_UNION im Element Typ angegeben werden. Der Triggertyp basiert darauf, wann der Trigger den Task ausführen wird.

Type

Eine TRIGGER_TYPE_UNION Struktur, die Details zum Trigger angibt. Beachten Sie, dass das TriggerType-Element bestimmt, welche Felder der TRIGGER_TYPE_UNION Union verwendet werden.

Reserved2

Nur für den internen Gebrauch; dieser Wert muss 0 sein.

wRandomMinutesInterval

Derzeit nicht verwendet.

Hinweise

Diese Zeiten können die Startzeit, Endzeit, Dauer und Änderungsflags für das Arbeitselement umfassen. Beachten Sie, dass beim Festlegen eines Triggers der Anfangstag Monat und Jahr festgelegt werden müssen.

Hinweis Für ein geplantes Arbeitselement können mindestens ein Trigger definiert sein. Die Zeiten, zu denen das Arbeitselement ausgeführt wird, ist die Union aller für dieses Element definierten Trigger.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	mstask.h