Partager via

Méthode IScheduledWorkItem ::GetExitCode (mstask.h)

  • Article

[[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 .] ]

Récupère le dernier code de sortie retourné par l’exécutable associé à l’élément de travail lors de sa dernière exécution. La méthode retourne également le code de sortie retourné au planificateur de tâches lors de la dernière tentative d’exécution de l’élément de travail.

Syntaxe

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Paramètres

[out] pdwExitCode

Pointeur vers une valeur DWORD définie sur le dernier code de sortie de l’élément de travail. Il s’agit du code de sortie que l’élément de travail a retourné lors de son dernier arrêt de l’exécution. Si l’élément de travail n’a jamais été démarré, 0 est retourné.

Valeur retournée

La méthode GetExitCode retourne l’erreur de la dernière tentative de démarrage de l’élément de travail. Les valeurs possibles sont les suivantes.

Code de retour Description
S_OK
 La tentative de démarrage de l’élément de travail a réussi.
SCHED_S_TASK_HAS_NOT_RUN
 Aucune tentative n’a jamais été effectuée pour démarrer cet élément de travail.
E_INVALIDARG
 Les arguments ne sont pas valides.
E_OUTOFMEMORY
 Mémoire disponible insuffisante.

Remarques

Cette méthode peut retourner les deux informations suivantes :

  • Le code d’erreur ou de sortie retourné par l’exécutable en cours de planification est retourné dans le paramètre pdwExitCode .
  • Le code d’erreur que le planificateur de tâches a reçu lorsqu’il a tenté de démarrer le travail est retourné dans l’appel de méthode GetExitCode lui-même.
Pour obtenir un code d’erreur mis à jour, appelez toujours ITaskScheduler ::Activate pour obtenir une nouvelle interface IScheduledWorkItem , qui peut ensuite être utilisée pour obtenir les codes d’erreur mis à jour.

Exemples

Pour obtenir un exemple de récupération du créateur d’une tâche, consultez Exemple de code C/C++ : Récupération du code de sortie de tâche.

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

IScheduledWorkItem