ITaskSettings::get_Priority-Methode (taskschd.h)
Ruft die Prioritätsebene der Aufgabe ab oder legt diese fest.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT get_Priority(
int *pPriority
);
Parameter
pPriority
Rückgabewert
Keine
Bemerkungen
Prioritätsebene 0 ist die höchste Priorität, und Prioritätsebene 10 ist die niedrigste Priorität. Der Standardwert ist 7. Die Prioritätsstufen 7 und 8 werden für Hintergrundaufgaben verwendet, und die Prioritätsstufen 4, 5 und 6 werden für interaktive Aufgaben verwendet.
Die Aktion der Aufgabe wird in einem Prozess mit einer Priorität gestartet, die auf einem Wert der Prioritätsklasse basiert. Ein Wert der Prioritätsebene (Threadpriorität) wird für COM-Handler-, Meldungsfeld- und E-Mail-Aufgabenaktionen verwendet. Weitere Informationen zu den Werten Prioritätsklasse und Prioritätsstufe finden Sie unter Zeitplanprioritäten. In der folgenden Tabelle sind die möglichen Werte für den Prioritätsparameter und die entsprechenden Werte für Prioritätsklasse und Prioritätsebene aufgeführt.
| Aufgabenpriorität | Prioritätsklasse | Prioritätsebene |
|---|---|---|
| 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 |
Beim Lesen oder Schreiben von XML für eine Aufgabe wird diese Einstellung im Priority (settingsType)- Element des Taskplanerschemas angegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | taskschd.h |
| Bibliothek | Taskschd.lib |
| DLL | Taskschd.dll |