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

Article
03/06/2024

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

Partager via