Méthode ITaskService ::GetRunningTasks (taskschd.h)

Article
07/16/2024

Obtient une collection de tâches en cours d’exécution.

RemarqueITaskService ::GetRunningTasks retourne uniquement une collection de tâches en cours d’exécution qui s’exécutent dans ou sous le contexte de sécurité d’un utilisateur. Par exemple, pour les membres du groupe Administrateurs, GetRunningTasks retourne une collection de toutes les tâches en cours d’exécution, mais pour les membres du groupe Users, GetRunningTasks retourne uniquement une collection de tâches exécutées sous le contexte de sécurité du groupe Utilisateurs.

Syntaxe

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

Paramètres

[in] flags

Valeur de l’énumération TASK_ENUM_FLAGS. Passez 0 pour retourner une collection de tâches en cours d’exécution qui ne sont pas masquées.

[out] ppRunningTasks

Interface IRunningTaskCollection qui contient les tâches en cours d’exécution.

Transmettez une référence à une référence NULLIRunningTaskCollection pointeur d’interface. Le référencement d’un pointeur NULL nonpeut provoquer une fuite de mémoire, car le pointeur sera remplacé.

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

	Description
E_INVALIDARG	Un argument non valide a été spécifié dans l’appel de méthode. Le passage d’une valeur différente de zéro aux indicateurs paramètre retourne E_INVALIDARG.
S_OK	L’opération s’est terminée avec succès.
E_POINTER	NULL a été passé dans le paramètre retVal.
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)	L’utilisateur n’a pas connecté au service.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	taskschd.h
bibliothèque	Taskschd.lib
DLL	Taskschd.dll

Voir aussi

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

planificateur de tâches

Partager via