Создает новый триггер для задачи.
Синтаксис
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
планировщик задач