ITaskSettings::p ut_Priority-Methode (taskschd.h)
Ruft die Prioritätsebene des Vorgangs ab oder legt sie fest.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_Priority(
int priority
);
Parameter
priority
Rückgabewert
Keine
Bemerkungen
Prioritätsstufe 0 ist die höchste Priorität, und Prioritätsstufe 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 Prioritätsklassenwert basiert. Ein Wert der Prioritätsstufe (Threadpriorität) wird für COM-Handler, Meldungsfeld- und E-Mail-Aufgabenaktionen verwendet. Weitere Informationen zu den Werten der Prioritätsklasse und Prioritätsstufe finden Sie unter Planungsprioritäten. Dieser Wert wirkt sich auch auf die Arbeitsspeicherpriorität aus (siehe MEMORY_PRIORITY_INFORMATION). In der folgenden Tabelle sind die möglichen Werte für den Prioritätsparameter sowie die entsprechenden Werte für Priority Class und Priority Level aufgeführt.
| Aufgabenpriorität | Priority-Klasse | Prioritätsstufe |
|---|---|---|
| 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 einen Vorgang wird diese Einstellung im Priority (settingsType) -Element des Aufgabenplanungsschemas 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 |