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

Метод ITaskTrigger::SetTrigger (mstask.h)

  • Статья

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

Метод SetTrigger задает критерии триггера для триггера задачи.

Синтаксис

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

Параметры

[in] pTrigger

Указатель на структуру TASK_TRIGGER , содержащую значения, определяющие новый триггер задачи.

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

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

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

Комментарии

Члены 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

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

IPersistFile::Save

ITaskTrigger

ITaskTrigger::GetTrigger

TASK_TRIGGER