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