Méthode ITask ::SetMaxRunTime (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 .] ]
Cette méthode définit la durée maximale pendant laquelle la tâche peut s’exécuter, en millisecondes, avant de se terminer.
Syntaxe
HRESULT SetMaxRunTime(
[in] DWORD dwMaxRunTimeMS
);
Paramètres
[in] dwMaxRunTimeMS
Valeur DWORD qui spécifie la durée d’exécution maximale (en millisecondes) de la tâche. Ce paramètre peut être défini sur INFINITE pour spécifier un temps illimité.
Valeur retournée
La méthode SetMaxRunTime retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Les arguments ne sont pas valides. |
|
Mémoire disponible insuffisante. |
Remarques
Lorsque la durée d’exécution maximale est dépassée, le planificateur de tâches tente d’arrêter l’application associée à la tâche. Si un message WM_CLOSE ne peut pas être envoyé (par exemple, l’application n’a pas de fenêtres) ou si l’application ne s’est pas arrêtée dans les trois minutes suivant la réception de l’WM_CLOSE, le planificateur de tâches met fin à l’application à l’aide de TerminateProcess.
Après avoir défini la durée d’exécution maximale, veillez à appeler IPersistFile ::Save pour enregistrer l’objet de tâche modifié sur le disque.
Exemples
Pour obtenir un exemple de définition de la durée d’exécution maximale, consultez Exemple de code C/C++ : Définition de MaxRunTime.
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 |
| Bibliothèque | Mstask.lib |
| DLL | Mstask.dll |
| Composant redistribuable | Internet Explorer 4.0 ou version ultérieure sur Windows NT 4.0 et Windows 95 |