Метод ITriggerCollection::Create (taskschd.h)

Статья
07/16/2024

Создает новый триггер для задачи.

Синтаксис

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

Параметры

[in] type

Этот параметр имеет одно из следующих констант перечисления TASK_TRIGGER_TYPE2.

Ценность	Значение
TASK_TRIGGER_EVENT 0	Активирует задачу при возникновении определенного события.
TASK_TRIGGER_TIME 1	Активирует задачу в определенное время суток.
TASK_TRIGGER_DAILY 2	Активирует задачу по ежедневному расписанию. Например, задача начинается в определенное время каждый день, каждый день, каждый день, каждый третий день и т. д.
TASK_TRIGGER_WEEKLY 3	Активирует задачу в еженедельном расписании. Например, задача начинается в 8:00 в определенный день каждую неделю или другую неделю.
TASK_TRIGGER_MONTHLY 4	Активирует задачу по ежемесячному расписанию. Например, задача начинается в определенные дни определенных месяцев.
TASK_TRIGGER_MONTHLYDOW 5	Активирует задачу по ежемесячному расписанию недели. Например, задача начинается с определенных дней недели, недель месяца и месяцев года.
TASK_TRIGGER_IDLE 6	Активирует задачу, когда компьютер переходит в состояние простоя.
TASK_TRIGGER_REGISTRATION 7	Активирует задачу при регистрации задачи.
TASK_TRIGGER_BOOT 8	Активирует задачу при загрузке компьютера.
TASK_TRIGGER_LOGON 9	Активирует задачу при входе определенного пользователя.
TASK_TRIGGER_SESSION_STATE_CHANGE 11	Активирует задачу при изменении состояния определенного сеанса.

[out] ppTrigger

Интерфейс ITrigger, представляющий новый триггер.

Передайте ссылку на указатель интерфейса NULLITrigger. Ссылка на указатель, неNULL может привести к утечке памяти, так как указатель будет перезаписан.

Возвращаемое значение

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	taskschd.h
библиотеки	Taskschd.lib
DLL	Taskschd.dll

См. также

ITriggerCollection

планировщик задач

Поделиться через