Partager via

Méthode ITaskSettings ::get_Priority (taskschd.h)

  • Article

Obtient ou définit le niveau de priorité de la tâche.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_Priority(
  int *pPriority
);

Paramètres

pPriority

Valeur de retour

None

Remarques

Le niveau de priorité 0 est la priorité la plus élevée, et le niveau de priorité 10 est la priorité la plus basse. La valeur par défaut est 7. Les niveaux de priorité 7 et 8 sont utilisés pour les tâches en arrière-plan, et les niveaux de priorité 4, 5 et 6 sont utilisés pour les tâches interactives.

L’action de la tâche est démarrée dans un processus avec une priorité basée sur une valeur de classe de priorité. Une valeur de niveau de priorité (priorité de thread) est utilisée pour les actions de gestionnaire COM, de boîte de message et de tâche de messagerie. Pour plus d’informations sur les valeurs Classe de priorité et Niveau de priorité, consultez Planification des priorités. Le tableau suivant répertorie les valeurs possibles pour le paramètre de priorité , ainsi que les valeurs Priority Class et Priority Level correspondantes.

Priorité de la tâche Classe Priority Niveau de priorité
0 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL
1 HIGH_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST
2 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
3 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
4 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
5 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
6 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
7 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
8 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
9 IDLE_PRIORITY_CLASS THREAD_PRIORITY_LOWEST
10 IDLE_PRIORITY_CLASS THREAD_PRIORITY_IDLE
 

Lors de la lecture ou de l’écriture de code XML pour une tâche, ce paramètre est spécifié dans l’élément Priority (settingsType) du schéma task Scheduler.

Configuration requise

Condition requise Valeur
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

ITaskSettings