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

Article
07/16/2024

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 dans ou sous le contexte de sécurité d’un utilisateur. Par exemple, pour les membres du groupe Administrateurs, GetInstances retourne toutes les instances de la tâche actuellement en cours d’exécution, mais pour les membres du groupe Utilisateurs, GetInstances retourne uniquement les instances de la tâche actuellement inscrite 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é pour 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 à 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.

Retourner le code	Description
S_OK	L’opération s’est terminée avec succès.
E_INVALIDARG	Un indicateur non null a été passé dans les indicateurs paramètre.
E_POINTER	NULL a été transmis au paramètre ppRunningTasks.

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

IRegisteredTask

IRunningTaskCollection

planificateur de tâches

Partager via