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

Voir aussi

IScheduledWorkItem

ITaskScheduler ::Activate

ITaskScheduler ::NewWorkItem