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 |
|
| DLL |
|