MONTHLYDOW structure (mstask.h)

  • Article

Defines the date(s) that the task runs by month, week, and day of the week.

Syntax

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

Members

wWhichWeek

Specifies the week of the month when the task runs. This value is exclusive and is one of the following flags.

Flag Meaning
TASK_FIRST_WEEK
 The task will run between the first and seventh day of the month.
TASK_SECOND_WEEK
 The task will run between the eighth and 14th day of the month.
TASK_THIRD_WEEK
 The task will run between the 15th and 21st day of the month.
TASK_FOURTH_WEEK
 The task will run between the 22nd and 28th of the month.
TASK_LAST_WEEK
 The task will run between the last seven days of the month.

rgfDaysOfTheWeek

Specifies the day(s) of the week (specified in wWhichWeek) when the task runs. This value is a combination of the following flags.

Flag Meaning
TASK_SUNDAY
 The task will run on Sunday.
TASK_MONDAY
 The task will run on Monday.
TASK_TUESDAY
 The task will run on Tuesday.
TASK_WEDNESDAY
 The task will run on Wednesday.
TASK_THURSDAY
 The task will run on Thursday.
TASK_FRIDAY
 The task will run on Friday.
TASK_SATURDAY
 The task will run on Saturday.

rgfMonths

Value that describes the month(s) when the task runs. This value is a combination of the following flags.

Flag Meaning
TASK_JANUARY
 The task will run in January.
TASK_FEBRUARY
 The task will run in February.
TASK_MARCH
 The task will run in March.
TASK_APRIL
 The task will run in April.
TASK_MAY
 The task will run in May.
TASK_JUNE
 The task will run in June.
TASK_JULY
 The task will run in July.
TASK_AUGUST
 The task will run in August.
TASK_SEPTEMBER
 The task will run in September.
TASK_OCTOBER
 The task will run in October.
TASK_NOVEMBER
 The task will run in November.
TASK_DECEMBER
 The task will run in December.

Remarks

The TRIGGER_TYPE_UNION union uses an instance of this structure as part of the Type member of the TASK_TRIGGER structure definition.

The following C++ example shows how to combine these flags. The example runs a task on the Monday and the Friday of the third week of every third month.

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header mstask.h

See also

IMonthlyDOWTrigger

TASK_TRIGGER

TRIGGER_TYPE_UNION