Метод IScheduledWorkItem::D eleteTrigger (mstask.h)
[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]
Удаляет триггер из рабочего элемента.
Синтаксис
HRESULT DeleteTrigger(
[in] WORD iTrigger
);
Параметры
[in] iTrigger
Значение индекса триггера, указывающее триггер, который требуется удалить. Дополнительные сведения см. в подразделе "Примечания".
Возвращаемое значение
Метод DeleteTrigger возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Недопустимые аргументы. |
|
Недостаточно памяти. |
Комментарии
Индекс триггера создается для каждого триггера при создании триггера. Однако это не уникальный идентификатор для конкретного триггера. Например, если создать четыре триггера, они будут нумерованы от 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 |