SetPriority-Methode der Win32_Process-Klasse

Die SetPriority-WMI-Klassenmethode versucht, die Ausführungspriorität des Prozesses zu ändern.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 SetPriority(
  [in] sint32 Priority
);

Parameter

Priorität [in]

Neue Prioritätsklasse für den Prozess. Beachten Sie, dass sich diese Werte von denen unterscheiden, die explizit in der Priority-Eigenschaftvon Win32_Process angegeben sind.

Leerlauf (64)

Wird für einen Prozess mit Threads angegeben, die nur ausgeführt werden, wenn sich das System im Leerlauf befindet. Die Threads des Prozesses werden von den Threads eines Prozesses, die in einer Klasse mit höherer Priorität ausgeführt werden, z. B. einem Bildschirmschoner, vorbelastet. Die Leerlaufprioritätsklasse wird von untergeordneten Prozessen geerbt.

Unter Normal (16384)

Gibt einen Prozess an, der über IDLE_PRIORITY_CLASS, aber unterhalb NORMAL_PRIORITY_CLASS Priorität hat.

Normal (32)

Wird für einen Prozess ohne besondere Planungsanforderungen angegeben.

Über Normal (32768)

Gibt einen Prozess an, der über NORMAL_PRIORITY_CLASS, aber unterhalb HIGH_PRIORITY_CLASS.

Hohe Priorität (128)

Wird für einen Prozess angegeben, der zeitkritische Aufgaben ausführt, die sofort ausgeführt werden müssen. Die Threads des Prozesses haben Vorrang vor den Threads von Prozessen in den Prioritätsklassen mit normaler oder Leerlaufpriorität. Ein Beispiel ist die Aufgabenliste, die unabhängig von der Auslastung des Betriebssystems schnell reagieren muss, wenn der Benutzer aufgerufen wird. Verwenden Sie bei Verwendung der Klasse mit hoher Priorität äußerste Sorgfalt, da eine Anwendung mit hoher Priorität fast die gesamte verfügbare CPU-Zeit nutzen kann.

Echtzeit (256)

Wird für einen Prozess angegeben, der die höchstmögliche Priorität hat. Die Threads des Prozesses verdrängen die Threads aller anderen Prozesse, einschließlich Betriebssystemprozessen, die wichtige Aufgaben ausführen. Beispielsweise kann ein Echtzeitprozess, der mehr als ein sehr kurzes Intervall ausgeführt wird, dazu führen, dass Datenträgercaches nicht leer werden oder eine Maus nicht reagiert.

Rückgabewert

Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolgreicher Abschluss (0)

Zugriff verweigert (2)

Unzureichende Berechtigungen (3)

Unbekannter Fehler (8)

Pfad nicht gefunden (9)

Ungültiger Parameter (21)

Sonstige (22 4294967295)

Bemerkungen

Um die Priorität auf Realtime festzulegen, muss der Aufrufer über SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE) verfügen. Ohne dieses Recht kann die höchste Priorität festgelegt werden.

Beispiele

Im VBScript-Beispiel Ändern der Priorität eines ausgeführten Prozesses wird die Priorität einer ausgeführten instance von Notepad.exe von Normal in Über Normal geändert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

Betriebssystemklassen

Win32_Process