Méthode ITaskSettings ::get_Priority (taskschd.h)
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 |