Share via

ITaskSettings::p ut_Priority-Methode (taskschd.h)

  • Artikel

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
  Die Aufgabenpriorität 4 entspricht der Arbeitsspeicherpriorität "MEMORY_PRIORITY_NORMAL(5)", 5 "MEMORY_PRIORITY_BELOW_NORMAL(4)" und 6 "MEMORY_PRIORITY_MEDIUM(3)".

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

Weitere Informationen

ITaskSettings