структура TASK_TRIGGER (mstask.h)

Статья
05.03.2025

Определяет время запуска запланированного рабочего элемента.

Синтаксис

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;

Члены

cbTriggerSize

Размер этой структуры в байтах.

Reserved1

Только для внутреннего использования; это значение должно быть равно нулю.

wBeginYear

Год активации триггера задачи. Это значение должно иметь четыре цифры (1997, а не 97). При настройке задачи необходимо указать начальный год.

wBeginMonth

Месяц года (указанный в элементе wBeginYear), активируемый триггером задачи. При настройке задачи необходимо указать начальный месяц.

wBeginDay

День месяца (указанный в элементе wBeginMonth), активируемый триггером задачи. При настройке задачи необходимо указать начальный день.

wEndYear

Год деактивации триггера задачи. Это значение должно иметь четыре цифры (1997, а не 97).

wEndMonth

Месяц года (указанный в элементе wEndYear), который активирует триггер задачи.

wEndDay

День месяца (указанный в элементе wEndMonth), который активирует триггер задачи.

wStartHour

Час дня выполнения задачи. Это значение равно 24-часовым часам; часы идут от 00 до 23.

wStartMinute

Минута часа (указанного в элементе wStartHour), выполняемого задачей.

MinutesDuration

Количество минут после запуска задачи, которое триггер останется активным. Число минут, указанное здесь, должно быть больше или равно параметру MinutesInterval.

Например, если вы запускаете задачу в 8:00 утра и хотите повторно запустить задачу до 5:00 вечера, в течение 540 минут будет 540 минут.

MinutesInterval

Количество минут между последовательными выполнениями задач. Это число подсчитывается с начала предыдущей запланированной задачи. Количество минут, указанное здесь, должно быть меньше параметра MinutesDuration.

Например, чтобы выполнять задачу каждый час от 8:00 до 5:00 вечера, задайте для этого поля значение 60.

rgFlags

Значение, описывающее поведение триггера. Это значение представляет собой сочетание следующих флагов.

TASK_TRIGGER_FLAG_HAS_END_DATE

Дата окончания структуры триггера действительна. Если этот флаг не задан, данные даты окончания игнорируются, и триггер будет действительным на неопределенный срок.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

Задача будет прекращена в конце времени существования активного триггера. В конце срока планировщик задач отправляет WM_CLOSE сообщение связанному приложению. Если WM_CLOSE не удается отправить (например, приложение не имеет окон) или приложение не завершилось в течение трех минут после получения WM_CLOSE, планировщик задач завершает приложение с помощью TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

Триггер задачи неактивен.

TriggerType

Перечисленное значение TASK_TRIGGER_TYPE, указывающее тип триггера. Этот элемент используется с типом. Тип триггера, указанный здесь, определяет, какие поля TRIGGER_TYPE_UNION, указанные в элементе Type. Тип триггера основан на том, когда триггер запустит задачу.

Type

Структура TRIGGER_TYPE_UNION, указывающая сведения о триггере. Обратите внимание, что элемент triggerType определяет, какие поля объединения TRIGGER_TYPE_UNION будут использоваться.

Reserved2

Только для внутреннего использования; это значение должно быть равно нулю.

wRandomMinutesInterval

В настоящее время не используется.

Замечания

Эти времена могут включать время начала, время окончания, длительность и флаги изменения для рабочего элемента. Обратите внимание, что при настройке триггера необходимо задать начальный месяц и год.

примечание запланированный рабочий элемент может иметь один или несколько триггеров. Время запуска рабочего элемента — объединение всех триггеров, определенных для этого элемента.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	mstask.h