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

Статья
08/25/2023

Задает контекст для указанного потока.

64-разрядное приложение может задать контекст потока WOW64 с помощью функции Wow64SetThreadContext .

Синтаксис

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Параметры

[in] hThread

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

[in] lpContext

Указатель на структуру CONTEXT , содержащую контекст, который необходимо задать в указанном потоке. Значение элемента ContextFlags этой структуры указывает, какие части контекста потока следует задать. Некоторые значения в структуре CONTEXT , которые не могут быть указаны, автоматически присваиваются правильному значению. Сюда входят биты в регистре состояния ЦП, определяющие режим привилегированного процессора, глобальные разряды включения в регистре отладки и другие состояния, которыми должна управлять операционная система.

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

Если контекст задан, возвращаемое значение не равно нулю.

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

Функция задает контекст потока на основе значения члена ContextFlags структуры контекста. Поток, определенный параметром hThread , обычно выполняется отладка, но функция также может работать даже в том случае, если поток не выполняет отладку.

Не пытайтесь задать контекст для выполняющихся потоков; Результаты непредсказуемы. Используйте функцию SuspendThread , чтобы приостановить поток перед вызовом Метода SetThreadContext.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	processthreadsapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll