Méthode IRegisteredTask::GetInstances (taskschd.h)

Article
08/26/2023

Retourne toutes les instances de la tâche inscrite en cours d’exécution.

RemarqueIRegisteredTask::GetInstances retourne uniquement les instances de la tâche inscrite en cours d’exécution qui s’exécutent au niveau ou en dessous du contexte de sécurité d’un utilisateur. Par exemple, pour les membres du groupe Administrateurs, GetInstances retourne toutes les instances de la tâche inscrite en cours d’exécution, mais pour les membres du groupe Utilisateurs, GetInstances retourne uniquement les instances de la tâche inscrite en cours d’exécution qui s’exécutent sous le contexte de sécurité du groupe Utilisateurs.

Syntaxe

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

Paramètres

flags

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur 0.

[out] ppRunningTasks

Interface IRunningTaskCollection qui contient toutes les instances en cours d’exécution de la tâche dans le contexte de l’utilisateur.

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

Valeur retournée

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

Code de retour	Description
S_OK	L’opération s’est terminée avec succès.
E_INVALIDARG	Un indicateur non null a été passé dans le paramètre flags .
E_POINTER	NULL a été passé dans le paramètre ppRunningTasks .

Configuration requise


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

IRunningTaskCollection

Planificateur de tâches

Partager via