Export (0) Print
Expand All

SetPriority method of the Win32_Process class

The SetPriorityWMI class method attempts to change the execution priority of the process.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax


uint32 SetPriority(
  [in]  sint32 Priority
);

Parameters

Priority [in]

New priority class for the process. Note that these values are different than those explicitly stated in the Priority property of Win32_Process.

ValueMeaning
64 (0x40)

Idle

Specified for a process with threads that run only when the system is idle. The threads of the process are preempted by the threads of a process that run in a higher priority class, for example, a screen saver. The idle-priority class is inherited by child processes.

16384 (0x4000)

Below Normal

Indicates a process that has priority above IDLE_PRIORITY_CLASS, but below NORMAL_PRIORITY_CLASS.

32 (0x20)

Normal

Specified for a process with no special scheduling needs.

32768 (0x8000)

Above Normal

Indicates a process that has priority above NORMAL_PRIORITY_CLASS, but below HIGH_PRIORITY_CLASS.

128 (0x80)

High Priority

Specified for a process that performs time-critical tasks that must be executed immediately. The threads of the process preempt the threads of normal or idle priority class processes. An example is the Task List, which must respond quickly when called by the user, regardless of the load on the operating system. Use extreme care when using the high-priority class, because a high-priority class application can use nearly all of the available CPU time.

256 (0x100)

Real Time

Specified for a process that has the highest possible priority. The threads of the process preempt the threads of all of the other processes, including operating system processes that perform important tasks. For example, a real-time process that executes for more than a very brief interval can cause disk caches not to flush or a mouse to be unresponsive.

 

Return value

Return codeDescription
0

Successful completion

2

Access denied

3

Insufficient Privilege

8

Unknown Failure

9

Path Not Found

21

Invalid Parameter

 

Remarks

To set the priority to Realtime, the caller must have SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE). Without this privilege, the highest the priority can be set to is High Priority.

Examples

The Modify the Priority Of a Running Process VBScript sample changes the priority of a running instance of Notepad.exe from Normal to Above Normal.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Operating System Classes
Win32_Process

 

 

Show:
© 2014 Microsoft