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

  • Статья

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

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

Синтаксис

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

Параметры

[in] iTrigger

Значение индекса триггера, указывающее триггер, который требуется удалить. Дополнительные сведения см. в подразделе "Примечания".

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

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

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

Комментарии

Индекс триггера создается для каждого триггера при создании триггера. Однако это не уникальный идентификатор для конкретного триггера. Например, если создать четыре триггера, они будут нумерованы от 0 до 3. Но если второй триггер удален, остальные триггеры будут нумерованы от 0 до 2. Обратите внимание, что индекс первого триггера всегда равен 0, а индекс последнего триггера на единицу меньше общего числа триггеров для рабочего элемента (TriggerCount -1).

Количество триггеров можно получить с помощью IScheduledWorkItem::GetTriggerCount.

Чтобы завершить удаление триггера, программы должны вызывать метод IPersistFile::Save после вызова DeleteTrigger. Вызов 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

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

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount