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

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

  • Статья

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

Синтаксис

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

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