Интерфейс ITaskSettings (taskschd.h)
Предоставляет параметры, которые служба планировщика задач использует для выполнения задачи.
Наследование
Интерфейс ITaskSettings наследуется от интерфейса IDispatch.
Методы
Интерфейс ITaskSettings содержит следующие методы.
| ITaskSettings::get_AllowDemandStart Возвращает или задает логическое значение, указывающее, что задачу можно запустить с помощью команды Выполнить или контекстного меню. (Получить) |
| ITaskSettings::get_AllowHardTerminate Возвращает или задает логическое значение, указывающее, что задача может быть завершена службой планировщика задач с помощью TerminateProcess. (Получить) |
| ITaskSettings::get_Compatibility Возвращает или задает целочисленное значение, указывающее, с какой версией планировщика задач совместима задача. (Получить) |
| ITaskSettings::get_DeleteExpiredTaskAfter Возвращает или задает время ожидания планировщика задач перед удалением задачи по истечении срока ее действия. (Получить) |
| ITaskSettings::get_DisallowStartIfOnBatteries Возвращает или задает логическое значение, указывающее, что задача не будет запущена, если компьютер работает от батарей. (Получить) |
| ITaskSettings::get_Enabled Возвращает или задает логическое значение, указывающее, что задача включена. Задача может быть выполнена только в том случае, если этот параметр имеет значение True. |
| ITaskSettings::get_ExecutionTimeLimit Возвращает или задает количество времени, разрешенное для выполнения задачи. (Получить) |
| ITaskSettings::get_Hidden Возвращает или задает логическое значение, указывающее, что задача не будет отображаться в пользовательском интерфейсе. (Получить) |
| ITaskSettings::get_IdleSettings Возвращает или задает сведения, указывающие, как планировщик задач выполняет задачи, когда компьютер находится в состоянии простоя. (Получить) |
| ITaskSettings::get_MultipleInstances Возвращает или задает политику, которая определяет, как планировщик задач взаимодействует с несколькими экземплярами задачи. (Получить) |
| ITaskSettings::get_NetworkSettings Возвращает или задает объект параметров сети, содержащий идентификатор и имя сетевого профиля. (Получить) |
| ITaskSettings::get_Priority Возвращает или задает уровень приоритета задачи. (Получить) |
| ITaskSettings::get_RestartCount Возвращает или задает количество попыток перезапуска задачи планировщиком задач. (Получить) |
| ITaskSettings::get_RestartInterval Возвращает или задает значение, указывающее, как долго планировщик задач будет пытаться перезапустить задачу. (Получить) |
| ITaskSettings::get_RunOnlyIfIdle Возвращает или задает логическое значение, указывающее, что планировщик задач будет выполнять задачу только в том случае, если компьютер находится в состоянии простоя. (Получить) |
| ITaskSettings::get_RunOnlyIfNetworkAvailable Возвращает или задает логическое значение, указывающее, что планировщик задач будет выполнять задачу только при наличии сети. (Получить) |
| ITaskSettings::get_StartWhenAvailable Возвращает или задает логическое значение, указывающее, что планировщик задач может запустить задачу в любое время после истечения запланированного времени. (Получить) |
| ITaskSettings::get_StopIfGoingOnBatteries Возвращает или задает логическое значение, указывающее, что задача будет остановлена, если компьютер переходит на батареи. (Получить) |
| ITaskSettings::get_WakeToRun Возвращает или задает логическое значение, указывающее, что планировщик задач разбудит компьютер, когда настанет время выполнения задачи, и не будет работать, пока задача не будет завершена. (Получить) |
| ITaskSettings::get_XmlText Возвращает или задает определение параметров задачи в формате XML. (Получить) |
| ITaskSettings::p ut_AllowDemandStart Возвращает или задает логическое значение, указывающее, что задачу можно запустить с помощью команды Выполнить или контекстного меню. (Put) |
| ITaskSettings::p ut_AllowHardTerminate Возвращает или задает логическое значение, указывающее, что задача может быть завершена службой планировщика задач с помощью TerminateProcess. (Put) |
| ITaskSettings::p ut_Compatibility Возвращает или задает целочисленное значение, указывающее, с какой версией планировщика задач совместима задача. (Put) |
| ITaskSettings::p ut_DeleteExpiredTaskAfter Возвращает или задает время ожидания планировщика задач перед удалением задачи по истечении срока ее действия. (Put) |
| ITaskSettings::p ut_DisallowStartIfOnBatteries Возвращает или задает логическое значение, указывающее, что задача не будет запущена, если компьютер работает от батарей. (Put) |
| ITaskSettings::p ut_ExecutionTimeLimit Возвращает или задает количество времени, разрешенное для выполнения задачи. (Put) |
| ITaskSettings::p ut_hidden Возвращает или задает логическое значение, указывающее, что задача не будет отображаться в пользовательском интерфейсе. (Put) |
| ITaskSettings::p ut_IdleSettings Возвращает или задает сведения, указывающие, как планировщик задач выполняет задачи, когда компьютер находится в состоянии простоя. (Put) |
| ITaskSettings::p ut_MultipleInstances Возвращает или задает политику, которая определяет, как планировщик задач взаимодействует с несколькими экземплярами задачи. (Put) |
| ITaskSettings::p ut_NetworkSettings Возвращает или задает объект параметров сети, содержащий идентификатор и имя сетевого профиля. (Put) |
| ITaskSettings::p ut_Priority Возвращает или задает уровень приоритета задачи. (Put) |
| ITaskSettings::p ut_RestartCount Возвращает или задает количество попыток перезапуска задачи планировщиком задач. (Put) |
| ITaskSettings::p ut_RestartInterval Возвращает или задает значение, указывающее, как долго планировщик задач будет пытаться перезапустить задачу. (Put) |
| ITaskSettings::p ut_RunOnlyIfIdle Возвращает или задает логическое значение, указывающее, что планировщик задач будет выполнять задачу только в том случае, если компьютер находится в состоянии простоя. (Put) |
| ITaskSettings::p ut_RunOnlyIfNetworkAvailable Возвращает или задает логическое значение, указывающее, что планировщик задач будет выполнять задачу только при наличии сети. (Put) |
| ITaskSettings::p ut_StartWhenAvailable Возвращает или задает логическое значение, указывающее, что планировщик задач может запустить задачу в любое время после истечения запланированного времени. (Put) |
| ITaskSettings::p ut_StopIfGoingOnBatteries Возвращает или задает логическое значение, указывающее, что задача будет остановлена, если компьютер переходит на батареи. (Put) |
| ITaskSettings::p ut_WakeToRun Возвращает или задает логическое значение, указывающее, что планировщик задач разбудит компьютер, когда настанет время выполнения задачи, и не будет работать, пока задача не будет завершена. (Put) |
| ITaskSettings::p ut_XmlText Возвращает или задает определение параметров задачи в формате XML. (Put) |
Комментарии
По умолчанию задача будет остановлена через 72 часа после запуска. Это можно изменить, изменив параметр ExecutionTimeLimit .
При чтении или записи XML для задачи параметры задачи определяются в элементе Settings схемы планировщика задач.
Если функция экономии заряда включена, задачи планировщика задач Windows активируются только в том случае, если задача:
- Не задано значение Запуск задачи, только если компьютер неактивен... (задача не использует IdleSettings)
- Не задано для запуска во время автоматического обслуживания (задача не использует MaintenanceSettings)
- Для параметра задано значение Запуск, только если пользователь вошел в систему (задача LogonType — TASK_LOGON_INTERACTIVE_TOKEN или TASK_LOGON_GROUP).
Примеры
Дополнительные сведения и пример кода для этого интерфейса см. в разделе Пример триггера времени (C++).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | taskschd.h |