Interface ITaskSettings (taskschd.h)
Fournit les paramètres que le service Planificateur de tâches utilise pour effectuer la tâche.
Héritage
L’interface ITaskSettings hérite de l’interface IDispatch.
Méthodes
L’interface ITaskSettings utilise ces méthodes.
| ITaskSettings ::get_AllowDemandStart Obtient ou définit une valeur booléenne qui indique que la tâche peut être démarrée à l’aide de la commande Exécuter ou du menu contextuel. (Get) |
| ITaskSettings ::get_AllowHardTerminate Obtient ou définit une valeur booléenne qui indique que la tâche peut être arrêtée par le service Planificateur de tâches à l’aide de TerminateProcess. (Get) |
| ITaskSettings ::get_Compatibility Obtient ou définit une valeur entière qui indique la version du planificateur de tâches avec laquelle une tâche est compatible. (Get) |
| ITaskSettings ::get_DeleteExpiredTaskAfter Obtient ou définit la durée pendant laquelle le planificateur de tâches attend avant de supprimer la tâche après son expiration. (Get) |
| ITaskSettings ::get_DisallowStartIfOnBatteries Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas démarrée si l’ordinateur s’exécute sur batteries. (Get) |
| ITaskSettings ::get_Enabled Obtient ou définit une valeur booléenne qui indique que la tâche est activée. La tâche peut être effectuée uniquement lorsque ce paramètre a la valeur True. |
| ITaskSettings ::get_ExecutionTimeLimit Obtient ou définit la durée autorisée pour terminer la tâche. (Get) |
| ITaskSettings ::get_Hidden Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas visible dans l’interface utilisateur. (Get) |
| ITaskSettings ::get_IdleSettings Obtient ou définit les informations qui spécifient comment le planificateur de tâches effectue les tâches lorsque l’ordinateur est inactif. (Get) |
| ITaskSettings ::get_MultipleInstances Obtient ou définit la stratégie qui définit la façon dont le planificateur de tâches traite plusieurs instances de la tâche. (Get) |
| ITaskSettings ::get_NetworkSettings Obtient ou définit l’objet de paramètres réseau qui contient un identificateur et un nom de profil réseau. (Get) |
| ITaskSettings ::get_Priority Obtient ou définit le niveau de priorité de la tâche. (Get) |
| ITaskSettings ::get_RestartCount Obtient ou définit le nombre de fois où le planificateur de tâches tente de redémarrer la tâche. (Get) |
| ITaskSettings ::get_RestartInterval Obtient ou définit une valeur qui spécifie la durée pendant laquelle le planificateur de tâches tente de redémarrer la tâche. (Get) |
| ITaskSettings ::get_RunOnlyIfIdle Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches exécute la tâche uniquement si l’ordinateur est inactif. (Get) |
| ITaskSettings ::get_RunOnlyIfNetworkAvailable Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches exécute la tâche uniquement lorsqu’un réseau est disponible. (Get) |
| ITaskSettings ::get_StartWhenAvailable Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches peut démarrer la tâche à tout moment une fois son heure planifiée passée. (Get) |
| ITaskSettings ::get_StopIfGoingOnBatteries Obtient ou définit une valeur booléenne qui indique que la tâche sera arrêtée si l’ordinateur est en cours d’exécution. (Get) |
| ITaskSettings ::get_WakeToRun Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches va réveiller l’ordinateur quand il est temps d’exécuter la tâche, et maintenir l’ordinateur éveillé jusqu’à ce que la tâche soit terminée. (Get) |
| ITaskSettings ::get_XmlText Obtient ou définit une définition au format XML des paramètres de tâche. (Get) |
| ITaskSettings ::p ut_AllowDemandStart Obtient ou définit une valeur booléenne qui indique que la tâche peut être démarrée à l’aide de la commande Exécuter ou du menu contextuel. (Put) |
| ITaskSettings ::p ut_AllowHardTerminate Obtient ou définit une valeur booléenne qui indique que la tâche peut être arrêtée par le service Planificateur de tâches à l’aide de TerminateProcess. (Put) |
| ITaskSettings ::p ut_Compatibility Obtient ou définit une valeur entière qui indique la version du planificateur de tâches avec laquelle une tâche est compatible. (Put) |
| ITaskSettings ::p ut_DeleteExpiredTaskAfter Obtient ou définit la durée pendant laquelle le planificateur de tâches attend avant de supprimer la tâche après son expiration. (Put) |
| ITaskSettings ::p ut_DisallowStartIfOnBatteries Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas démarrée si l’ordinateur s’exécute sur batteries. (Put) |
| ITaskSettings ::p ut_ExecutionTimeLimit Obtient ou définit la durée autorisée pour terminer la tâche. (Put) |
| ITaskSettings ::p ut_Hidden Obtient ou définit une valeur booléenne qui indique que la tâche ne sera pas visible dans l’interface utilisateur. (Put) |
| ITaskSettings ::p ut_IdleSettings Obtient ou définit les informations qui spécifient comment le planificateur de tâches effectue les tâches lorsque l’ordinateur est inactif. (Put) |
| ITaskSettings ::p ut_MultipleInstances Obtient ou définit la stratégie qui définit la façon dont le planificateur de tâches traite plusieurs instances de la tâche. (Put) |
| ITaskSettings ::p ut_NetworkSettings Obtient ou définit l’objet de paramètres réseau qui contient un identificateur et un nom de profil réseau. (Put) |
| ITaskSettings ::p ut_Priority Obtient ou définit le niveau de priorité de la tâche. (Put) |
| ITaskSettings ::p ut_RestartCount Obtient ou définit le nombre de fois où le planificateur de tâches tente de redémarrer la tâche. (Put) |
| ITaskSettings ::p ut_RestartInterval Obtient ou définit une valeur qui spécifie la durée pendant laquelle le planificateur de tâches tente de redémarrer la tâche. (Put) |
| ITaskSettings ::p ut_RunOnlyIfIdle Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches n’exécutera la tâche que si l’ordinateur est inactif. (Put) |
| ITaskSettings ::p ut_RunOnlyIfNetworkAvailable Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches n’exécute la tâche que lorsqu’un réseau est disponible. (Put) |
| ITaskSettings ::p ut_StartWhenAvailable Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches peut démarrer la tâche à tout moment une fois son heure planifiée passée. (Put) |
| ITaskSettings ::p ut_StopIfGoingOnBatteries Obtient ou définit une valeur booléenne qui indique que la tâche sera arrêtée si l’ordinateur est sur batteries. (Put) |
| ITaskSettings ::p ut_WakeToRun Obtient ou définit une valeur booléenne qui indique que le planificateur de tâches réveille l’ordinateur lorsqu’il est temps d’exécuter la tâche et maintient l’ordinateur éveillé jusqu’à ce que la tâche soit terminée. (Put) |
| ITaskSettings ::p ut_XmlText Obtient ou définit une définition au format XML des paramètres de tâche. (Put) |
Remarques
Par défaut, une tâche est arrêtée 72 heures après le début de son exécution. Vous pouvez modifier ce paramètre en modifiant le paramètre ExecutionTimeLimit .
Lors de la lecture ou de l’écriture de code XML pour une tâche, les paramètres de tâche sont définis dans l’élément Settings du schéma Task Scheduler.
Lorsque l’économiseur de batterie est activé, les tâches du Planificateur de tâches Windows sont déclenchées uniquement si la tâche est :
- Non défini sur Démarrer la tâche uniquement si l’ordinateur est inactif... (la tâche n’utilise pas IdleSettings)
- Non défini pour s’exécuter pendant la maintenance automatique (la tâche n’utilise pas MaintenanceSettings)
- Est défini sur Exécuter uniquement lorsque l’utilisateur est connecté (la tâche LogonType est TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP)
Exemples
Pour plus d’informations et un exemple de code pour cette interface, consultez Time Trigger Example (C++).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | taskschd.h |