TASK_TRIGGER structure (mstask.h)

Article
08/25/2023

Définit les heures d’exécution d’un élément de travail planifié.

Syntaxe

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;

Membres

cbTriggerSize

Taille de cette structure, en octets.

Reserved1

Pour une utilisation interne uniquement ; cette valeur doit être égale à zéro.

wBeginYear

Année d’activation du déclencheur de tâche. Cette valeur doit être de quatre chiffres (1997, et non 97). L’année de début doit être spécifiée lors de la définition d’une tâche.

wBeginMonth

Mois de l’année (spécifié dans le membre wBeginYear ) que le déclencheur de tâche active. Le mois de début doit être spécifié lors de la définition d’une tâche.

wBeginDay

Jour du mois (spécifié dans le membre wBeginMonth ) que le déclencheur de tâche active. Le jour de début doit être spécifié lors de la définition d’une tâche.

wEndYear

Année de désactivation du déclencheur de tâche. Cette valeur doit être de quatre chiffres (1997, et non 97).

wEndMonth

Mois de l’année (spécifié dans le membre wEndYear ) que le déclencheur de tâche désactive.

wEndDay

Jour du mois (spécifié dans le membre wEndMonth ) que le déclencheur de tâche désactive.

wStartHour

Heure du jour où la tâche s’exécute. Cette valeur est sur une horloge de 24 heures ; heures passent de 00 à 23.

wStartMinute

Minute de l’heure (spécifiée dans le membre wStartHour ) pendant laquelle la tâche s’exécute.

MinutesDuration

Nombre de minutes après le démarrage de la tâche pendant lesquelles le déclencheur reste actif. Le nombre de minutes spécifié ici doit être supérieur ou égal au paramètre MinutesInterval .

Par exemple, si vous démarrez une tâche à 8h00 et que vous souhaitez la démarrer à plusieurs reprises jusqu’à 17h00, la durée est de 540 minutes.

MinutesInterval

Nombre de minutes entre les exécutions de tâches consécutives. Ce nombre est compté à partir du début de la tâche planifiée précédente. Le nombre de minutes spécifié ici doit être inférieur au paramètre MinutesDuration .

Par exemple, pour exécuter une tâche toutes les heures de 8h00 à 17h00, définissez ce champ sur 60.

rgFlags

Valeur qui décrit le comportement du déclencheur. Cette valeur est une combinaison des indicateurs suivants.

TASK_TRIGGER_FLAG_HAS_END_DATE

La date de fin de la structure du déclencheur est valide. Si cet indicateur n’est pas défini, les données de date de fin sont ignorées et le déclencheur est valide indéfiniment.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

La tâche est terminée à la fin de la durée de vie du déclencheur actif. À la fin de la durée, le planificateur de tâches envoie un message WM_CLOSE à l’application associée. Si WM_CLOSE ne peut pas être envoyé (par exemple, l’application n’a pas de fenêtre) ou si l’application ne s’est pas arrêtée dans les trois minutes suivant la réception de l’WM_CLOSE, le planificateur de tâches arrête l’application à l’aide de TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

Le déclencheur de tâche est inactif.

TriggerType

Valeur énumérée TASK_TRIGGER_TYPE qui spécifie le type de déclencheur. Ce membre est utilisé avec Type. Le type de déclencheur spécifié ici détermine quels champs de l’TRIGGER_TYPE_UNION spécifié dans Type membre seront utilisés. Le type de déclencheur est basé sur le moment où le déclencheur exécutera la tâche.

Type

Structure TRIGGER_TYPE_UNION qui spécifie des détails sur le déclencheur. Notez que le membre TriggerType détermine les champs de l’union TRIGGER_TYPE_UNION qui seront utilisés.

Reserved2

Pour une utilisation interne uniquement ; cette valeur doit être égale à zéro.

wRandomMinutesInterval

Pas utilisé pour l'instant.

Remarques

Ces heures peuvent inclure l’heure de début, l’heure de fin, la durée et les indicateurs de modification de l’élément de travail. Notez que lors de la définition d’un déclencheur, le mois et l’année du jour de début doivent être définis.

Note Un ou plusieurs déclencheurs peuvent être définis pour un élément de travail planifié. La durée d’exécution de l’élément de travail correspond à l’union de tous les déclencheurs définis pour cet élément.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	mstask.h