Функция SetThreadPriorityBoost (processthreadsapi.h)

Статья
08/25/2023

Отключает или включает возможность системы временно повысить приоритет потока.

Синтаксис

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

Параметры

[in] hThread

Дескриптор для потока, приоритет которого должен быть увеличен. Дескриптор должен иметь право доступа к THREAD_SET_INFORMATION или THREAD_SET_LIMITED_INFORMATION . Дополнительные сведения см. в разделе Безопасность потоков и права доступа.

Windows Server 2003 и Windows XP: Дескриптор должен иметь право доступа THREAD_SET_INFORMATION .

[in] bDisablePriorityBoost

Если этот параметр имеет значение TRUE, динамическое повышение отключено. Если параметр имеет значение FALSE, включено динамическое повышение.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Когда поток выполняется в одном из классов динамического приоритета, система временно повышает приоритет потока при выходе из состояния ожидания. Если метод SetThreadPriorityBoost вызывается с параметром DisablePriorityBoost , равным TRUE, приоритет потока не увеличивается. Чтобы восстановить нормальное поведение, вызовите команде SetThreadPriorityBoost , а параметру DisablePriorityBoost присвоено значение FALSE.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	processthreadsapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Библиотека	Kernel32.lib
DLL	Kernel32.dll