Méthode IShellTaskScheduler ::AddTask (shobjidl_core.h)

Article
03/06/2024

Ajoute une tâche à la file d’attente en arrière-plan du planificateur.

Syntaxe

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Paramètres

[in] prt

Type : IRunnableTask*

Pointeur vers un instance d’une interface IRunnableTask représentant la tâche à ajouter à la file d’attente.

[in] rtoid

Type : REFTASKOWNERID

GUID identifiant le propriétaire de la tâche. Ces informations peuvent être utilisées pour regrouper des tâches en vue d’un comptage ou d’une suppression ultérieure par le propriétaire.

[in] lParam

Type : DWORD_PTR

Pointeur vers une valeur DWORD définie par l’utilisateur permettant d’identifier la tâche dans les tâches appartenant à rtoid. Il est utilisé pour identifier des tâches uniques ou les sous-groupes, pour instance associer la tâche à un élément particulier tel qu’un élément dans un ListView. Ce paramètre peut être égal à zéro.

[in] dwPriority

Type : DWORD

L’une des valeurs suivantes affectant la priorité de la tâche. La réponse à cette priorité dépend de la coopération des autres tâches exécutées. Les nouvelles tâches sont insérées dans la file d’attente dans l’ordre de priorité. Si une tâche de faible priorité est actuellement en cours d’exécution lorsqu’une tâche de priorité plus élevée est ajoutée, le planificateur tente de suspendre la tâche en cours d’exécution. Cette tâche de priorité inférieure reprend lorsque la ou les tâches de priorité supérieure sont terminées.

ITSAT_DEFAULT_PRIORITY

Acceptez la priorité par défaut affectée à la tâche par le planificateur.

ITSAT_MAX_PRIORITY

Haute priorité.

ITSAT_MIN_PRIORITY

Priorité basse.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

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	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via