IRegisteredTask ::GetRunTimes, méthode (taskschd.h)
Obtient les heures auxquelles la tâche inscrite est planifiée pour s’exécuter pendant une heure spécifiée.
Syntaxe
HRESULT GetRunTimes(
[in] const LPSYSTEMTIME pstStart,
[in] const LPSYSTEMTIME pstEnd,
[in, out] DWORD *pCount,
[out] LPSYSTEMTIME *pRunTimes
);
Paramètres
[in] pstStart
Heure de début de la requête.
[in] pstEnd
Heure de fin de la requête.
[in, out] pCount
Nombre d’exécutions demandé lors de l’entrée et nombre retourné d’exécutions en sortie.
[out] pRunTimes
Heures planifiées pendant laquelle la tâche s’exécutera. Un objet LPSYSTEMTIME NULL doit être passé dans ce paramètre. Au retour, ce tableau contient les temps d’exécution pCount . Vous devez libérer ce tableau en appelant la fonction CoTaskMemFree .
Valeur retournée
Si la méthode réussit, retourne S_OK. Si la méthode retourne S_FALSE, le paramètre pRunTimes contient des éléments pCount, mais d’autres exécutions de la tâche n’ont pas été retournées. Sinon, elle retourne un code d’erreur HRESULT.
Notes
Si la tâche inscrite contient des déclencheurs qui sont désactivés individuellement, ces déclencheurs affectent toujours l’heure d’exécution planifiée suivante qui est retournée même s’ils sont désactivés.
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 |