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
S_OK	L'opération a réussi.
E_INVALIDARG	Les arguments ne sont pas valides.
E_OUTOFMEMORY	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

Voir aussi

IGetMaxRunTime

Itask