Partager via


Méthode ITaskSettings ::get_ExecutionTimeLimit (taskschd.h)

Obtient ou définit la durée autorisée à effectuer la tâche. Par défaut, une tâche est arrêtée 72 heures après le début de son exécution. Vous pouvez modifier cela en modifiant ce paramètre.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_ExecutionTimeLimit(
  BSTR *pExecutionTimeLimit
);

Paramètres

pExecutionTimeLimit

Valeur de retour

None

Remarques

Le format de cette chaîne est PnYnMnDTnHnMnS, où nY est le nombre d’années, nM est le nombre de mois, nD est le nombre de jours, 'T' est le séparateur de date/heure, nH est le nombre d’heures, nM est le nombre de minutes et nS est le nombre de secondes (par exemple, PT5M spécifie 5 minutes et P1M4DT2H5M spécifie un mois, quatre jours, deux heures et cinq minutes). La valeur PT0S permet à la tâche de s’exécuter indéfiniment.

Note Si une tâche est démarrée à la demande, le paramètre ExecutionTimeLimit est contourné. Par conséquent, une tâche démarrée à la demande n’est pas arrêtée si elle dépasse la valeur ExecutionTimeLimit.
 
Lors de la lecture ou de l’écriture de code XML pour une tâche, ce paramètre est spécifié dans l’élément ExecutionTimeLimit du schéma Task Scheduler.

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
Bibliothèque Taskschd.lib
DLL Taskschd.dll

Voir aussi

ITaskSettings

Planificateur de tâches