Méthode IScheduledWorkItem ::GetStatus (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 .] ]
Récupère la status de l’élément de travail.
HRESULT GetStatus(
[out] HRESULT *phrStatus
);
[out] phrStatus
Pointeur vers une valeur HRESULT qui contient l’une des valeurs suivantes au retour.
L’élément de travail est prêt à s’exécuter à l’heure planifiée suivante.
L’élément de travail est en cours d’exécution.
Une ou plusieurs des propriétés nécessaires à l’exécution de cette tâche selon une planification n’ont pas été définies.
La tâche n’a pas été exécutée. Cette valeur est retournée chaque fois que la tâche n’a pas été exécutée, même si la tâche est prête à être exécutée à l’heure planifiée suivante ou si la tâche est une tâche périodique.
La tâche ne s’exécutera pas aux heures planifiées, car elle a été désactivée.
Il n’y a plus d’exécutions planifiées pour cette tâche.
La tâche n’a pas de déclencheurs ou les déclencheurs existants sont désactivés ou non définis.
La méthode GetStatus retourne l’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
L'opération a réussi. La demande a été envoyée. Pour plus d'informations, consultez la section Notes. |
|
Les arguments ne sont pas valides. |
Les méthodes de l’interface IScheduledWorkItem sont héritées par l’interface ITask . Par conséquent, IScheduledWorkItem ::GetStatus est généralement appelé via l’interface ITask .
IScheduledWorkItem ::GetStatus n’obtient pas dynamiquement le status de la tâche. ITaskScheduler ::Activate doit être appelé pour obtenir une nouvelle interface IScheduledWorkItem, qui est utilisée pour obtenir une status mise à jour. Pour plus d’informations, consultez l’exemple pour ITaskScheduler ::Activate.
Pour obtenir un exemple de récupération des status d’une tâche, consultez Exemple de code C/C++ : récupération de l’état de la tâche.
Pour obtenir un exemple de récupération de la tâche status dans le cadre de l’arrêt de la tâche, consultez Exemple de fin de tâche.
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 |