IRegisteredTask ::GetRunTimes, méthode (taskschd.h)

Article
03/06/2024

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

Voir aussi

IRegisteredTask

Planificateur de tâches

Partager via