Partager via

Méthode IScheduledWorkItem ::GetRunTimes (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 les heures d’exécution de l’élément de travail pendant une période spécifiée.

Syntaxe

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

Paramètres

[in] pstBegin

Pointeur vers une structure SYSTEMTIME qui contient l’heure de début de la période vers case activée. Cette valeur est inclusive.

[in] pstEnd

Pointeur vers une structure SYSTEMTIME qui contient l’heure de fin de la période vers case activée. Cette valeur est exclusive. Si NULL est passé pour cette valeur, l’heure de fin est infinie.

[in, out] pCount

Pointeur vers une valeur WORD qui spécifie le nombre d’exécutions à récupérer.

En entrée, ce paramètre contient le nombre d’exécutions demandées. Il peut s’agir d’un nombre compris entre 1 et TASK_MAX_RUN_TIMES.

Sur la sortie, ce paramètre contient le nombre d’exécutions récupérées.

[out] rgstTaskTimes

Pointeur vers un tableau de structures SYSTEMTIME . Un objet NULL LPSYSTEMTIME doit être passé dans ce paramètre. Au retour, ce tableau contient les heures d’exécution pCount . Vous devez libérer ce tableau en appelant la fonction CoTaskMemFree .

Valeur retournée

La méthode GetRunTimes retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 Le nombre de fois d’exécution demandé a été récupéré.
S_FALSE
 La méthode a réussi, mais moins que le nombre d’exécutions demandé a été récupéré. Le nombre d’exécutions récupérées est contenu dans la valeur pointée par pCount. Si le nombre d’exécutions récupérées est égal à zéro, il n’existe pas non plus de déclencheurs basés sur des événements qui peuvent entraîner l’exécution de l’élément de travail pendant la période spécifiée.
SCHED_S_TASK_NO_VALID_TRIGGERS
 L’élément de travail est activé, mais n’a pas de déclencheurs valides.
SCHED_S_TASK_DISABLED
 L’élément de travail est désactivé.
E_INVALIDARG
 Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY
 La mémoire est insuffisante pour calculer le résultat.

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