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

Статья
03/05/2024

[[Этот 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