Modifies a scheduled task on the HFSQL server defined by the connection. This task is in an
hScheduledTask variable.
Remark:
HInfoTask is used to retrieve the characteristics of a scheduled task in a variable of type
hScheduledTask.
MyConnection is Connection
MyTask is hScheduledTask
// Retrieve the characteristics of the task
MyTask = HInfoTask(MyConnection, TaskID)
// Modify the task
MyTask.Hour = EDT_Time.Hour+1
HModifyTask(MyConnection, TaskID, MyTask)
Syntax
<Result> = HModifyTask(<Connection> , <Task identifier> , <Scheduled task>)
<Result>: Boolean
- True if the scheduled task was modified,
- False if an error occurred.
<Connection>: Character string or Connection variable
Connection for which a task must be added. This connection corresponds to:
<Task identifier>: Integer
Identifier of the task to modify. This identifier is returned by HAddTask.
<Scheduled task>: hScheduledTask variable
Name of the hScheduledTask variable that contains the modifications.
Remarks
Necessary rights
To modify a task, you must have:
- the corresponding rights (hRightsManageTask constant) on the server,
- the rights to run the command linked to the scheduled task.
The task will be run with the account of user who created the task.
Remark: The scheduled task will not be performed if the server is switched off. The scheduled task will be performed at the next available date when the server is switched on.