Метод ITask::SetMaxRunTime (mstask.h)

  • Статья

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

Этот метод задает максимальное время выполнения задачи в миллисекундах до завершения.

Синтаксис

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

Параметры

[in] dwMaxRunTimeMS

Значение DWORD , указывающее максимальное время выполнения (в миллисекундах) для задачи. Для этого параметра можно задать значение INFINITE, чтобы указать неограниченное время.

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

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

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

Комментарии

При превышении максимального времени выполнения планировщик задач пытается завершить работу приложения, связанного с задачей. Если не удается отправить сообщение WM_CLOSE (например, приложение не имеет окон) или приложение не завершило работу в течение трех минут после получения WM_CLOSE, планировщик задач завершает приложение с помощью TerminateProcess.

Задав максимальное время выполнения, вызовите IPersistFile::Save , чтобы сохранить измененный объект задачи на диске.

Примеры

Пример установки максимального времени выполнения см. в разделе C/C++ Code Example: Setting MaxRunTime.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mstask.h
Библиотека Mstask.lib
DLL Mstask.dll
Распространяемые компоненты Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

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

IGetMaxRunTime

ITask