Interfaz ITaskSettings (taskschd.h)
Proporciona la configuración que usa el servicio Programador de tareas para realizar la tarea.
Herencia
La interfaz ITaskSettings hereda de la interfaz IDispatch.
Métodos
La interfaz ITaskSettings tiene estos métodos.
| ITaskSettings::get_AllowDemandStart Obtiene o establece un valor booleano que indica que la tarea se puede iniciar mediante el comando Ejecutar o el menú Contextual. (Obtener) |
| ITaskSettings::get_AllowHardTerminate Obtiene o establece un valor booleano que indica que el servicio Programador de tareas puede finalizar la tarea mediante TerminateProcess. (Obtener) |
| ITaskSettings::get_Compatibility Obtiene o establece un valor entero que indica con qué versión del Programador de tareas es compatible una tarea. (Obtener) |
| ITaskSettings::get_DeleteExpiredTaskAfter Obtiene o establece la cantidad de tiempo que el Programador de tareas esperará antes de eliminar la tarea después de que expire. (Obtener) |
| ITaskSettings::get_DisallowStartIfOnBatteries Obtiene o establece un valor booleano que indica que la tarea no se iniciará si el equipo se ejecuta en baterías. (Obtener) |
| ITaskSettings::get_Enabled Obtiene o establece un valor booleano que indica que la tarea está habilitada. La tarea solo se puede realizar cuando esta configuración es True. |
| ITaskSettings::get_ExecutionTimeLimit Obtiene o establece la cantidad de tiempo que se permite completar la tarea. (Obtener) |
| ITaskSettings::get_Hidden Obtiene o establece un valor booleano que indica que la tarea no estará visible en la interfaz de usuario. (Obtener) |
| ITaskSettings::get_IdleSettings Obtiene o establece la información que especifica cómo realiza el Programador de tareas las tareas cuando el equipo está en una condición inactiva. (Obtener) |
| ITaskSettings::get_MultipleInstances Obtiene o establece la directiva que define cómo trabaja el Programador de tareas con varias instancias de la tarea. (Obtener) |
| ITaskSettings::get_NetworkSettings Obtiene o establece el objeto de configuración de red que contiene un identificador y un nombre de perfil de red. (Obtener) |
| ITaskSettings::get_Priority Obtiene o establece el nivel de prioridad de la tarea. (Obtener) |
| ITaskSettings::get_RestartCount Obtiene o establece el número de veces que el Programador de tareas intentará reiniciar la tarea. (Obtener) |
| ITaskSettings::get_RestartInterval Obtiene o establece un valor que especifica cuánto tiempo intentará reiniciar la tarea el Programador de tareas. (Obtener) |
| ITaskSettings::get_RunOnlyIfIdle Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo si el equipo está en una condición inactiva. (Obtener) |
| ITaskSettings::get_RunOnlyIfNetworkAvailable Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo cuando haya una red disponible. (Obtener) |
| ITaskSettings::get_StartWhenAvailable Obtiene o establece un valor booleano que indica que el Programador de tareas puede iniciar la tarea en cualquier momento después de que haya transcurrido su hora programada. (Obtener) |
| ITaskSettings::get_StopIfGoingOnBatteries Obtiene o establece un valor booleano que indica que la tarea se detendrá si el equipo va a cargar baterías. (Obtener) |
| ITaskSettings::get_WakeToRun Obtiene o establece un valor booleano que indica que el Programador de tareas reactivará el equipo cuando sea el momento de ejecutar la tarea y mantenga el equipo activo hasta que se complete la tarea. (Obtener) |
| ITaskSettings::get_XmlText Obtiene o establece una definición con formato XML de la configuración de la tarea. (Obtener) |
| ITaskSettings::p ut_AllowDemandStart Obtiene o establece un valor booleano que indica que la tarea se puede iniciar mediante el comando Ejecutar o el menú Contextual. (Put) |
| ITaskSettings::p ut_AllowHardTerminate Obtiene o establece un valor booleano que indica que el servicio Programador de tareas puede finalizar la tarea mediante TerminateProcess. (Put) |
| ITaskSettings::p ut_Compatibility Obtiene o establece un valor entero que indica con qué versión del Programador de tareas es compatible una tarea. (Put) |
| ITaskSettings::p ut_DeleteExpiredTaskAfter Obtiene o establece la cantidad de tiempo que el Programador de tareas esperará antes de eliminar la tarea después de que expire. (Put) |
| ITaskSettings::p ut_DisallowStartIfOnBatteries Obtiene o establece un valor booleano que indica que la tarea no se iniciará si el equipo se ejecuta en baterías. (Put) |
| ITaskSettings::p ut_ExecutionTimeLimit Obtiene o establece la cantidad de tiempo que se permite completar la tarea. (Put) |
| ITaskSettings::p ut_Hidden Obtiene o establece un valor booleano que indica que la tarea no estará visible en la interfaz de usuario. (Put) |
| ITaskSettings::p ut_IdleSettings Obtiene o establece la información que especifica cómo realiza el Programador de tareas las tareas cuando el equipo está en una condición inactiva. (Put) |
| ITaskSettings::p ut_MultipleInstances Obtiene o establece la directiva que define cómo trabaja el Programador de tareas con varias instancias de la tarea. (Put) |
| ITaskSettings::p ut_NetworkSettings Obtiene o establece el objeto de configuración de red que contiene un identificador y un nombre de perfil de red. (Put) |
| ITaskSettings::p ut_Priority Obtiene o establece el nivel de prioridad de la tarea. (Put) |
| ITaskSettings::p ut_RestartCount Obtiene o establece el número de veces que el Programador de tareas intentará reiniciar la tarea. (Put) |
| ITaskSettings::p ut_RestartInterval Obtiene o establece un valor que especifica cuánto tiempo intentará reiniciar la tarea el Programador de tareas. (Put) |
| ITaskSettings::p ut_RunOnlyIfIdle Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo si el equipo está en una condición inactiva. (Put) |
| ITaskSettings::p ut_RunOnlyIfNetworkAvailable Obtiene o establece un valor booleano que indica que el Programador de tareas ejecutará la tarea solo cuando haya una red disponible. (Put) |
| ITaskSettings::p ut_StartWhenAvailable Obtiene o establece un valor booleano que indica que el Programador de tareas puede iniciar la tarea en cualquier momento después de que haya transcurrido su hora programada. (Put) |
| ITaskSettings::p ut_StopIfGoingOnBatteries Obtiene o establece un valor booleano que indica que la tarea se detendrá si el equipo va a cargar baterías. (Put) |
| ITaskSettings::p ut_WakeToRun Obtiene o establece un valor booleano que indica que el Programador de tareas reactivará el equipo cuando sea el momento de ejecutar la tarea y mantenga el equipo activo hasta que se complete la tarea. (Put) |
| ITaskSettings::p ut_XmlText Obtiene o establece una definición con formato XML de la configuración de la tarea. (Put) |
Comentarios
De forma predeterminada, una tarea se detendrá 72 horas después de empezar a ejecutarse. Para cambiar esto, cambie la configuración ExecutionTimeLimit .
Al leer o escribir XML para una tarea, la configuración de la tarea se define en el elemento Settings del esquema del Programador de tareas.
Cuando el ahorro de batería está activado, las tareas del Programador de tareas de Windows solo se desencadenan si la tarea es:
- No está establecida en Iniciar la tarea solo si el equipo está inactivo... (la tarea no usa IdleSettings)
- No está establecida para ejecutarse durante el mantenimiento automático (la tarea no usa MaintenanceSettings)
- Está establecida en Ejecutar solo cuando el usuario ha iniciado sesión (la tarea LogonType es TASK_LOGON_INTERACTIVE_TOKEN o TASK_LOGON_GROUP)
Ejemplos
Para obtener más información y un ejemplo de código para esta interfaz, vea Ejemplo de desencadenador de hora (C++).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | taskschd.h |