Метод ITaskTrigger::SetTrigger (mstask.h)
[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]
Метод SetTrigger задает критерии триггера для триггера задачи.
Синтаксис
HRESULT SetTrigger(
[in] const PTASK_TRIGGER pTrigger
);
Параметры
[in] pTrigger
Указатель на структуру TASK_TRIGGER , содержащую значения, определяющие новый триггер задачи.
Возвращаемое значение
Метод SetTrigger возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Операция выполнена успешно. |
|
Недопустимые аргументы. |
|
Недостаточно памяти. |
Комментарии
Члены wBeginDay, wBeginMonth и wBeginYear структуры TASK_TRIGGER должны иметь допустимый день, месяц и год соответственно.
С задачей может быть связано любое количество триггеров. Время выполнения задачи — это объединение всех триггеров, определенных для этой задачи.
Чтобы обновить задачу с помощью этих новых параметров триггера, приложения должны вызывать метод IPersistFile::Save после вызова SetTrigger.
Примеры
В следующем коде показаны объявление переменной и синтаксис вызова для этого метода, включая необходимые элементы TASK_TRIGGER. Задание условий триггера при создании нового триггера см. в разделе Создание нового триггера.
HRESULT hr = S_OK;
TASK_TRIGGER Trigger;
ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));
Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;
// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
printf("Failed SetTrigger\n");
exit(1);
}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mstask.h |
| Библиотека | Mstask.lib |
| DLL | Mstask.dll |
| Распространяемые компоненты | Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95 |