Estrutura MONTHLYDOW (mstask.h)

Define as datas em que a tarefa é executada por mês, semana e dia da semana.

Sintaxe

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

Membros

wWhichWeek

Especifica a semana do mês em que a tarefa é executada. Esse valor é exclusivo e é um dos sinalizadores a seguir.

Sinalizador	Significado
TASK_FIRST_WEEK	A tarefa será executada entre o primeiro e o sétimo dia do mês.
TASK_SECOND_WEEK	A tarefa será executada entre o oitavo e o14º dia do mês.
TASK_THIRD_WEEK	A tarefa será executada entre os dias15 e21 do mês.
TASK_FOURTH_WEEK	A tarefa será executada entre os dias22 e28 do mês.
TASK_LAST_WEEK	A tarefa será executada entre os últimos sete dias do mês.

rgfDaysOfTheWeek

Especifica os dias da semana (especificados em wWhichWeek) quando a tarefa é executada. Esse valor é uma combinação dos sinalizadores a seguir.

Sinalizador	Significado
TASK_SUNDAY	A tarefa será executada no domingo.
TASK_MONDAY	A tarefa será executada na segunda-feira.
TASK_TUESDAY	A tarefa será executada na terça-feira.
TASK_WEDNESDAY	A tarefa será executada na quarta-feira.
TASK_THURSDAY	A tarefa será executada na quinta-feira.
TASK_FRIDAY	A tarefa será executada na sexta-feira.
TASK_SATURDAY	A tarefa será executada no sábado.

rgfMonths

Valor que descreve os meses em que a tarefa é executada. Esse valor é uma combinação dos sinalizadores a seguir.

Sinalizador	Significado
TASK_JANUARY	A tarefa será executada em janeiro.
TASK_FEBRUARY	A tarefa será executada em fevereiro.
TASK_MARCH	A tarefa será executada em março.
TASK_APRIL	A tarefa será executada em abril.
TASK_MAY	A tarefa será executada em maio.
TASK_JUNE	A tarefa será executada em junho.
TASK_JULY	A tarefa será executada em julho.
TASK_AUGUST	A tarefa será executada em agosto.
TASK_SEPTEMBER	A tarefa será executada em setembro.
TASK_OCTOBER	A tarefa será executada em outubro.
TASK_NOVEMBER	A tarefa será executada em novembro.
TASK_DECEMBER	A tarefa será executada em dezembro.

Comentários

A união TRIGGER_TYPE_UNION usa uma instância dessa estrutura como parte do membro Type da definição da estrutura TASK_TRIGGER .

O exemplo C++ a seguir mostra como combinar esses sinalizadores. O exemplo executa uma tarefa na segunda-feira e na sexta-feira da terceira semana de cada terceiro mês.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	mstask.h

Confira também

IMonthlyDOWTrigger

TASK_TRIGGER

TRIGGER_TYPE_UNION