Récupération d’exemples de propriétés de tâche
Pour récupérer les propriétés d’une tâche, appelez ITaskScheduler::Activate pour récupérer l’interface de l’objet de tâche, puis appelez la méthode ITask appropriée pour récupérer la propriété de tâche qui vous intéresse. Les exemples de code répertoriés en bas de la page montrent comment récupérer les différentes propriétés de tâche.
Les exemples de code répertoriés en bas de la page montrent comment récupérer les propriétés propres aux objets de tâche. Pour obtenir d’autres propriétés d’élément de travail qui s’appliquent également aux tâches, consultez Récupération d’exemples d’éléments de travail.
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, le nom de l’application, les paramètres ou le répertoire de travail), vous devez appeler CoTaskMemFree pour libérer la mémoire allouée pour 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 Task Scheduler. (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 cet exemple obtient la tâche « Tâche de test ».
- Appelez la méthode ITask appropriée pour récupérer la propriété qui vous intéresse.
- Traitez la propriété en fonction des besoins. (Ces exemples impriment 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 pour la chaîne retournée.
| Pour obtenir un exemple de code de | Consultez |
|---|---|
| Récupération du nom de l’application associée à une tâche donnée | Exemple de code C/C++ : récupération du nom de l’application de tâche |
| Récupération de la durée maximale pendant laquelle la tâche peut s’exécuter et affichage de ce nombre à l’écran | Exemple de code C/C++ : récupération de la tâche MaxRunTime |
| Récupération de la chaîne de paramètre exécutée lors de l’exécution de la tâche et affichage de cette chaîne à l’écran | Exemple de code C/C++ : récupération des paramètres de tâche |
| Récupération du niveau de priorité de la tâche | Exemple de code C/C++ : récupération de la priorité de tâche |
| Récupération du répertoire de travail d’une tâche et affichage du chemin d’accès au répertoire de travail à l’écran | Exemple de code C/C++ : récupération du répertoire de travail des tâches |
Rubriques connexes