Exemples de propriétés d’élément de travail
Pour récupérer les propriétés d’un élément de travail, appelez ITaskScheduler::Activate pour récupérer l’interface de l’objet élément de travail, puis appelez la méthode appropriée pour récupérer la propriété de tâche qui vous intéresse. Actuellement, les seuls éléments de travail valides sont des tâches.
Les exemples de code répertoriés en bas de cette page montrent comment récupérer les propriétés qui s’appliquent à tous les éléments de travail. Pour les autres propriétés propres aux tâches, consultez Définition d’exemples de propriétés de tâche.
Notes
Dans l’exemple de code suivant, toutes les interfaces sont libérées une fois qu’elles ne sont plus nécessaires.
Notez que si vous récupérez une propriété de chaîne (par exemple, un commentaire pour un élément de travail), vous devez appeler CoTaskMemFree pour libérer la mémoire allouée à la chaîne retournée.
La procédure suivante décrit comment récupérer une propriété de tâche.
Pour récupérer une propriété de tâche
- Appelez CoInitialize pour initialiser la bibliothèque COM et CoCreateInstance pour obtenir un objet Planificateur de tâches. (Ces exemples supposent que le service Planificateur de tâches est en cours d’exécution.)
- Appelez ITaskScheduler::Activate pour obtenir l’interface ITask de l’objet de tâche. (Notez que les tâches sont actuellement le seul type d’élément de travail valide.)
- Appelez la méthode appropriée pour récupérer la propriété qui vous intéresse.
- Traitez la propriété en fonction des besoins. (Ces exemples impriment simplement la propriété à l’écran.)
- Si la propriété retournée est une chaîne, appelez CoTaskMemFree pour libérer la mémoire allouée à la chaîne retournée.
| Pour obtenir un exemple de code de | Consultez |
|---|---|
| Récupération des informations de compte d’une tâche connue | Exemple de code C/C++ : récupération des informations de compte de tâche |
| Récupération de la chaîne de commentaire d’une tâche connue | Exemple de code C/C++ : récupération d’un commentaire de tâche |
| Récupération du nom du créateur de la tâche et affichage à l’écran | Exemple de code C/C++ : récupération du créateur de la tâche |
| Récupération du dernier code de sortie retourné par une tâche connue | Exemple de code C/C++ : récupération du code de sortie de tâche |
| Récupération du temps d’inactivité de la tâche et affichage à l’écran | Exemple de code C/C++ : récupération du temps d’inactivité de la tâche |
| Récupération de l’heure de la dernière exécution de la tâche et affichage à l’écran | Exemple de code C/C++ : Récupération de la tâche MostRecentRun Time |
| Récupération de la prochaine exécution planifiée de la tâche et affichage de cette heure à l’écran | Exemple de code C/C++ : Récupération de la tâche NextRun Time |
| Récupération des heures d’exécution de la tâche et affichage à l’écran | Exemple de code C/C++ : récupération des heures d’exécution des tâches |
| Récupération du status actuel de la tâche et affichage à l’écran | Exemple de code C/C++ : récupération de l’état de la tâche |
Rubriques connexes