Interface IScheduledWorkItem (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 de gestion d’éléments de travail spécifiques.

Héritage

L’interface IScheduledWorkItem hérite de l’interface IUnknown. IScheduledWorkItem a également les types de membres suivants :

Méthodes

L’interface IScheduledWorkItem a ces méthodes.

 
IScheduledWorkItem ::CreateTrigger

Crée un déclencheur pour l’élément de travail.
IScheduledWorkItem ::D eleteTrigger

Supprime un déclencheur d’un élément de travail.
IScheduledWorkItem ::EditWorkItem

Affiche les pages de propriétés Tâche, Planification et Paramètres de l’élément de travail, ce qui permet à un utilisateur de définir les propriétés de ces pages.
IScheduledWorkItem ::GetAccountInformation

Récupère le nom du compte pour l’élément de travail.
IScheduledWorkItem ::GetComment

Récupère le commentaire de l’élément de travail.
IScheduledWorkItem ::GetCreator

Récupère le nom du créateur de l’élément de travail.
IScheduledWorkItem ::GetErrorRetryCount

Récupère le nombre de fois où le planificateur de tâches réessaye une opération lorsqu’une erreur se produit. Cette méthode n’est pas implémentée.
IScheduledWorkItem ::GetErrorRetryInterval

Récupère l’intervalle de temps, en minutes, entre les tentatives d’exécution d’un élément de travail par le planificateur de tâches en cas d’erreur. Cette méthode n’est pas implémentée.
IScheduledWorkItem ::GetExitCode

Récupère le dernier code de sortie retourné par l’exécutable associé à l’élément de travail lors de sa dernière exécution. La méthode retourne également le code de sortie retourné au planificateur de tâches lors de la dernière tentative d’exécution de l’élément de travail.
IScheduledWorkItem ::GetFlags

Récupère les indicateurs qui modifient le comportement de n’importe quel type d’élément de travail.
IScheduledWorkItem ::GetIdleWait

Récupère le temps d’attente d’inactivité de l’élément de travail.
IScheduledWorkItem ::GetMostRecentRunTime

Récupère l’heure la plus récente à laquelle l’élément de travail a commencé à s’exécuter.
IScheduledWorkItem ::GetNextRunTime

Récupère la prochaine fois que l’élément de travail s’exécutera.
IScheduledWorkItem ::GetRunTimes

Récupère les heures d’exécution de l’élément de travail pour une période spécifiée.
IScheduledWorkItem ::GetStatus

Récupère la status de l’élément de travail.
IScheduledWorkItem ::GetTrigger

Récupère un déclencheur de tâche.
IScheduledWorkItem ::GetTriggerCount

Récupère le nombre de déclencheurs pour l’élément de travail actuel.
IScheduledWorkItem ::GetTriggerString

Récupère une chaîne qui décrit le déclencheur d’élément de travail.
IScheduledWorkItem ::GetWorkItemData

Récupère les données définies par l’application associées à l’élément de travail.
IScheduledWorkItem ::Run

Envoie une demande au service Planificateur de tâches pour exécuter l’élément de travail.
IScheduledWorkItem ::SetAccountInformation

Définit le nom du compte et le mot de passe utilisés pour exécuter l’élément de travail.
IScheduledWorkItem ::SetComment

Définit le commentaire pour l’élément de travail.
IScheduledWorkItem ::SetCreator

Définit le nom du créateur de l’élément de travail.
IScheduledWorkItem ::SetErrorRetryCount

Définit le nombre de fois où le planificateur de tâches tente à nouveau d’exécuter l’élément de travail en cas d’erreur. Cette méthode n’est pas implémentée.
IScheduledWorkItem ::SetErrorRetryInterval

Définit l’intervalle de temps, en minutes, entre les tentatives du planificateur de tâches d’exécuter un élément de travail après qu’une erreur se soit produite. Cette méthode n’est pas implémentée.
IScheduledWorkItem ::SetFlags

Définit les indicateurs qui modifient le comportement de tout type d’élément de travail.
IScheduledWorkItem ::SetIdleWait

Définit les minutes pendant lesquelles le système doit être inactif avant que l’élément de travail puisse s’exécuter.
IScheduledWorkItem ::SetWorkItemData

Cette méthode stocke les données définies par l’application associées à l’élément de travail.
IScheduledWorkItem ::Terminate

Cette méthode met fin à l’exécution de l’élément de travail.

Remarques

L’interface IScheduledWorkItem est l’interface de base de l’interface ITask. Toutes les méthodes fournies par IScheduledWorkItem sont héritées par l’interface ITask et sont généralement appelées via cette interface.

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

Itask