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


Метод IScheduledWorkItem::CreateTrigger (mstask.h)

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Создает триггер для рабочего элемента.

Синтаксис

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Параметры

[out] piNewTrigger

Указатель на возвращаемое значение индекса триггера нового триггера. Индекс триггера для первого триггера, связанного с рабочим элементом, равен "0". См. примечания о других способах использования индекса триггера.

[out] ppTrigger

Указатель на указатель на интерфейс ITaskTrigger . В настоящее время единственными поддерживаемыми рабочими элементами являются задачи.

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

Метод CreateTrigger возвращает одно из следующих значений.

Код возврата Описание
S_OK
Операция выполнена успешно.
E_INVALIDARG
Недопустимые аргументы.
E_OUTOFMEMORY
Недостаточно памяти.

Комментарии

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

Чтобы задать условия для нового триггера, вызовите ITaskTrigger::SetTrigger.

После создания нового триггера для рабочего элемента приложения должны вызвать метод IPersistFile::Save , чтобы сохранить новый триггер на диске.

Примеры

Пример задания условий триггера при создании нового триггера см. в разделе Создание нового триггера.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

См. также раздел

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger