Méthode ITask ::SetPriority (mstask.h)

[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]

Cette méthode définit la priorité pour la tâche.

Syntaxe

HRESULT SetPriority(
  [in] DWORD dwPriority
);

Paramètres

[in] dwPriority

DWORD qui spécifie la priorité de la tâche actuelle. La priorité d’une tâche détermine la fréquence et la durée des tranches de temps d’un processus. Cela s’applique uniquement aux systèmes d’exploitation Windows Server 2003, Windows XP et Windows 2000. Ces valeurs sont extraites de la classe de priorité CreateProcess et peuvent être l’un des indicateurs suivants (dans l’ordre décroissant de la priorité de planification des threads) :

• REALTIME_PRIORITY_CLASS
• HIGH_PRIORITY_CLASS
• NORMAL_PRIORITY_CLASS
• IDLE_PRIORITY_CLASS

Valeur retournée

La méthode SetPriority retourne l’une des valeurs suivantes.

Remarques

Après avoir défini la priorité d’une tâche, appelez IPersistFile ::Save pour enregistrer l’objet de tâche modifié sur le disque.

Exemples

Pour plus d’informations et un exemple de définition de la priorité d’une tâche, consultez Exemple de code C/C++ : définition de la priorité de tâche.

Configuration requise

Voir aussi

GetPriority

Itask