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)
Todos los demás desencadenadores se retrasan hasta que el ahorro de batería está apagado. Para obtener más información sobre el acceso al estado de ahorro de batería en la aplicación, consulte SYSTEM_POWER_STATUS. Para obtener información general sobre el ahorro de batería, consulte ahorro de batería (en las directrices del componente de hardware).

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

Consulte también

IIdleSettings

INetworkSettings

ITaskDefinition