AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de Windows / Funciones del programador de Windows
  • Presentación
  • Estructura de tareas programadas
  • Ejemplo
  • Ejemplo para añadir una tarea
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
El Tareas programadas se utiliza para definir las características de una tarea programada. Las variables de esta estructura son reiniciadas por ProgramadorReiniciar.
Observación: Al crear una nueva tarea, se utiliza la estructura ScheduledTask y la estructura Activación de tareas programadas.
Estructura de tareas programadas
Las diferentes variables de la estructura de ScheduledTask son las siguientes:
Aplicación de tareas programadasCadena de caracteres.
Nombre y ruta del programa a ejecutar.
Tareas programadas ParadaParadaFinalizaciónBooleano.
True si debe detenerse la tarea tan pronto como el sistema reanuda una actividad.
Por defecto, el valor de esta variable es False.
Tareas programadas DetenerseEnBateríasBooleano.
True si el sistema debe detener la tarea cuando el equipo funciona con batería.
Por defecto, el valor de esta variable es True.
Código de error de tarea programadaEntero.
Último código de error devuelto por la tarea (0 si la tarea se completó con éxito o si el programa nunca se ha iniciado).
Esta Variable es de sólo lectura y se actualiza con Programador de tareasPropiedades.
ScheduledTask.commentCadena de caracteres.
comment associated con la tarea. Este comment será Visible en las propiedades de la tarea. Este comment puede ser multilingüe.
Tareas programadas.IdleWaitTimeoutEntero en minutos.
Tiempo de espera durante el cual el sistema esperará un tiempo de inactividad antes de realizar la tarea.
Si ScheduledTask.IdleTimeout no es set a 0, esta Variable se utiliza para especificar la cantidad de tiempo necesaria antes de que el sistema cancele la ejecución de la tarea.
Esta variable es set a 60 minutos por Default.
Tareas Programadas.IdleTimeoutEntero en minutos.
Cantidad de tiempo de inactividad del sistema requerido antes de realizar la tarea. La tarea se realizará sólo si el sistema es Inactive.
Ejemplo: Un escaneo antivirus se realiza todos los días a la 1:00 PM si el sistema es Inactive desde hace 30 minutos.
Esta variable es set a 0 (tiempo de espera inmediato) por Default.
Fecha de última ejecución de la tarea programadaFechaHora.
Fecha de la última ejecución de la tarea.
Esta Variable es de sólo lectura y se actualiza con Programador de tareasPropiedades.
ScheduledTask.MaxRunTimeDuración.
Duración máxima de la tarea. Cantidad de tiempo necesario antes de que el sistema finalice la tarea.
Si este Variable es set a 0, la tarea se ejecutará tanto tiempo como sea necesario.
Esta variable es set a 72 horas por Default.
Observación: Este Variable puede corresponder a:
  • un número entero que corresponde al número de centésimas de segundo,
  • una variable de tipo Duration,
  • la indicación directa de la duración (1 h por ejemplo).
Sistema de tareas programadasBooleano.
  • True si el equipo debe estar suspendido para ejecutar esta tarea (el sistema no debe estar suspendido),
  • False en caso contrario.
Por defecto, el valor de esta variable es False.
Ejecución de tareas programadasIfLoggedOnBooleano.
  • True si debe ejecutarse la tarea solo cuando se inicia una sesión interactiva (con identificación del usuario) en el equipo del usuario ScheduledTask.User,
  • False en caso contrario.
Esta función le permite no especificar la contraseña del usuario (sin embargo, se debe especificar el nombre de usuario).
Por defecto, el valor de esta variable es False: la tarea se ejecutará incluso si la sesión ha finalizado.
Observación: Este Variable requiere Windows XP o posterior (no funciona en Windows 2000).
Línea de comandos de tareas programadasCadena de caracteres.
Parámetros para pasar en el comando Line a la aplicación que se ejecutará.
Contraseña para tareas programadasCadena de caracteres.
Contraseña de usuario. Este usuario se especificó en ScheduledTask.User. Se utiliza para realizar una tarea programada de acuerdo con una cuenta de usuario..
Si se modifica esta contraseña, esta modificación también se aplicará a todas las tareas de relacionado para este usuario.
Cuenta de desencadenamiento de tareas programadasEntero.
Número de planes de tareas (lo que significa el número de eventos que desencadenarán la tarea).
Esta Variable es de sólo lectura y se actualiza con Programador de tareasPropiedades.
Tareas programadas: No ejecutar si las baterías están agotadasBooleano.
True si el sistema debe detener la tarea cuando el equipo funciona con batería.
Por defecto, el valor de esta variable es True.
Tareas programadas SiguienteEjecutarHoraFechaHora.
Fecha de la siguiente ejecución de la tarea programada.
Esta Variable es de sólo lectura y se actualiza con Programador de tareasPropiedades.
Directorio de trabajo de tareas programadasCadena de caracteres.
Directorio de trabajo de la aplicación a ejecutar (cadena vacía si el directorio de trabajo corresponde al directorio del programador (MSTASK.EXE)).
Atención: Si no se especifica este directorio, corresponde al directorio de ScheduledTask.Application.
Tareas programadasBorrarCuando se realizaBooleano.
True si debe eliminarse la tarea automáticamente cuando no hay más condiciones posibles para ejecutarla (por ejemplo, si se ha alcanzado la fecha limite de cada horario).
Por defecto, el valor de esta variable es False.
Usuario de tareas programadasCadena de caracteres.
Nombre del usuario cuya cuenta se utiliza para realizar la tarea.
Observación: si está usando un dominio, este dominio debe ser especificado.
Ejemplo

Ejemplo para añadir una tarea

SchedulerReset()
// Create the scheduled task
ScheduledTask.Application = "MyExecutable.exe"
ScheduledTask.CommandLine = QryAllAboutBackup.Name
ScheduledTask.SystemOn = True
ScheduledTask.Comment = "WINDEV program"
 
// Create the schedules for the scheduled task
// nBackupType is a radio button proposing a backup
// single, weekly or monthly backup...
 
TriggerScheduledTask.Type = nBackupType
 
// Execution date of the single backup
IF nBackupType = schedDaily THEN
IF EDT_SingleDate <> "" THEN
IF EDT_SingleTime <> "" THEN
TriggerScheduledTask.Date = EDT_SingleDate
TriggerScheduledTask.Time = EDT_SingleTime
ELSE
Info("Enter a valid backup time.")
RETURN
END
ELSE
Info("Enter a valid backup date.")
RETURN
END
END
// Monthly backup
IF nBackupType = schedMonthly THEN
IF EDT_SingleTime <> "" THEN
TriggerScheduledTask.Day = RADIO_DayOfMonth
TriggerScheduledTask.Time = EDT_SingleTime
ELSE
Info("Enter a valid backup time.")
RETURN
END
END
// Weekly backup
IF nBackupType = schedWeekly THEN
IF EDT_SingleTime <> "" THEN
TriggerScheduledTask.DayOfWeek = RADIO_DayOfWeek
TriggerScheduledTask.Time = EDT_SingleTime
ELSE
Info("Enter a valid backup time.")
RETURN
END
END
IF NOT SchedulerAddTask("MyTask") THEN
Error(ErrorInfo())
ELSE
Info("The application was added to the task manager of Windows")
END
Versión mínima requerida
  • Versión 10
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/08/2022

Señalar un error o enviar una sugerencia | Ayuda local