Updates the priority of a thread.

procedure SetThreadPriority(AThread: TThread; const APriority: TIdThreadPriority; const APolicy: Integer = -MaxInt);

The thread to be updated.

The thread priority value to be used for the thread.

SetThreadPriority is a procedure used to update the priority of the thread in AThread to the value specified in APriority. SetThreadPriority encapsulates the platform-specific procedures and functions used to update the priority of a thread. For the Windows platform, Priority is a published property of TThread.

On the Linux platform, thread priority can only be increased for threads running with "root" login permissions. In this situation, SetThreadPriority will only allow non-root threads to lower their thread priority using the libc setpriority function. An attempt to increase thread priority for a non-root thread is ignored.