Interface ITask (mstask.h)
[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]
Fournit les méthodes permettant d’exécuter des tâches, d’obtenir ou de définir des informations sur les tâches et d’arrêter des tâches. Il est dérivé de l’interface IScheduledWorkItem et hérite de toutes les méthodes de cette interface.
Héritage
L’interface ITask hérite de IScheduledWorkItem. ITask a également les types de membres suivants :
Méthodes
L’interface ITask a ces méthodes.
| ITask ::GetApplicationName Cette méthode récupère le nom de l’application à laquelle la tâche est associée. |
| ITask ::GetMaxRunTime Cette méthode récupère la durée maximale, en millisecondes, que la tâche peut s’exécuter avant de se terminer. |
| ITask ::GetParameters Cette méthode récupère les paramètres de ligne de commande de la tâche. |
| ITask ::GetPriority Cette méthode récupère la priorité de la tâche. |
| ITask ::GetTaskFlags Cette méthode retourne les indicateurs qui modifient le comportement d’une tâche. |
| ITask ::GetWorkingDirectory Cette méthode récupère le répertoire de travail de la tâche. |
| ITask ::SetApplicationName Cette méthode affecte une application spécifique à la tâche actuelle. |
| ITask ::SetMaxRunTime Cette méthode définit la durée maximale pendant laquelle la tâche peut s’exécuter, en millisecondes, avant de se terminer. |
| ITask ::SetParameters Cette méthode définit les paramètres de ligne de commande de la tâche. |
| ITask ::SetPriority Cette méthode définit la priorité de la tâche. |
| ITask ::SetTaskFlags Cette méthode définit les indicateurs qui modifient le comportement d’une tâche planifiée. |
| ITask ::SetWorkingDirectory Cette méthode définit le répertoire de travail de la tâche. |
Remarques
ITask est l’interface principale de l’objet déclencheur de tâche. Pour créer un objet de tâche, appelez ITaskScheduler ::Activate pour les tâches existantes ou ITaskScheduler ::NewWorkItem pour les nouvelles tâches.
Exemples
Pour plus d’informations et un exemple de code pour cette interface, consultez Exemple de code C/C++ : Fin d’une tâche.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | mstask.h |
| Composant redistribuable | Internet Explorer 4.0 ou version ultérieure sur Windows NT 4.0 et Windows 95 |