Partager via

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

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

  • Last updated on