Structure MONTHLYDOW (mstask.h)

Article
02/29/2024

Définit la ou les dates d’exécution de la tâche par mois, semaine et jour de la semaine.

Syntaxe

typedef struct _MONTHLYDOW {
  WORD wWhichWeek;
  WORD rgfDaysOfTheWeek;
  WORD rgfMonths;
} MONTHLYDOW;

Membres

wWhichWeek

Spécifie la semaine du mois où la tâche s’exécute. Cette valeur est exclusive et est l’un des indicateurs suivants.

Indicateur	Signification
TASK_FIRST_WEEK	La tâche s’exécutera entre le premier et le septième jour du mois.
TASK_SECOND_WEEK	La tâche s’exécutera entre le huitième et le 14^du mois.
TASK_THIRD_WEEK	La tâche s’exécutera entre le 15^et le^21e jour du mois.
TASK_FOURTH_WEEK	La tâche s’exécutera entre le 22^et le 28^du mois.
TASK_LAST_WEEK	La tâche s’exécutera entre les sept derniers jours du mois.

rgfDaysOfTheWeek

Spécifie le ou les jours de la semaine (spécifiés dans wWhichWeek) lors de l’exécution de la tâche. Cette valeur est une combinaison des indicateurs suivants.

Indicateur	Signification
TASK_SUNDAY	La tâche s’exécutera le dimanche.
TASK_MONDAY	La tâche s’exécutera lundi.
TASK_TUESDAY	La tâche s’exécutera mardi.
TASK_WEDNESDAY	La tâche s’exécutera le mercredi.
TASK_THURSDAY	La tâche s’exécutera jeudi.
TASK_FRIDAY	La tâche s’exécutera vendredi.
TASK_SATURDAY	La tâche s’exécutera le samedi.

rgfMonths

Valeur qui décrit le ou les mois auxquels la tâche s’exécute. Cette valeur est une combinaison des indicateurs suivants.

Indicateur	Signification
TASK_JANUARY	La tâche s’exécutera en janvier.
TASK_FEBRUARY	La tâche s’exécutera en février.
TASK_MARCH	La tâche s’exécutera en mars.
TASK_APRIL	La tâche s’exécutera en avril.
TASK_MAY	La tâche s’exécutera en mai.
TASK_JUNE	La tâche s’exécutera en juin.
TASK_JULY	La tâche s’exécutera en juillet.
TASK_AUGUST	La tâche s’exécutera en août.
TASK_SEPTEMBER	La tâche s’exécutera en septembre.
TASK_OCTOBER	La tâche s’exécutera en octobre.
TASK_NOVEMBER	La tâche s’exécutera en novembre.
TASK_DECEMBER	La tâche s’exécutera en décembre.

Remarques

L’union TRIGGER_TYPE_UNION utilise une instance de cette structure dans le cadre du membre Type de la définition de structure TASK_TRIGGER.

L’exemple C++ suivant montre comment combiner ces indicateurs. L’exemple exécute une tâche le lundi et le vendredi de la troisième semaine de chaque troisième mois.

MONTHLYDOW example;
example.wWhichWeek = TASK_THIRD_WEEK;
example.rgfDaysOfTheWeek = TASK_FRIDAY | TASK_MONDAY;
example.rgfMonths = TASK_JANUARY | TASK_APRIL | TASK_JULY | TASK_OCTOBER;

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

Voir aussi

IMonthlyDOWTrigger

TASK_TRIGGER

TRIGGER_TYPE_UNION

Partager via