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

Weitere Informationen

ITaskSettings