CWinThread::SetThreadPriority

This function sets the priority level of the current thread within its priority class.

BOOL SetThreadPriority(
   int nPriority 
);

Parameters

  • nPriority
    Specifies the new thread priority level within its priority class. This parameter must be one of the following values, listed from highest priority to lowest:

    • THREAD_PRIORITY_TIME_CRITICAL

    • THREAD_PRIORITY_HIGHEST

    • THREAD_PRIORITY_ABOVE_NORMAL

    • THREAD_PRIORITY_NORMAL

    • THREAD_PRIORITY_BELOW_NORMAL

    • THREAD_PRIORITY_LOWEST

    • THREAD_PRIORITY_IDLE

For more information on these priorities, see SetThreadPriority in the Windows SDK.

Return Value

Nonzero if function was successful; otherwise 0.

Remarks

It can only be called after CreateThread successfully returns.

Requirements

Header: afxwin.h

See Also

Concepts

CWinThread Class

CWinThread Members

Hierarchy Chart

CWinThread::GetThreadPriority

SetThreadPriority