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

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

Синтаксис

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

Параметры

[in] hThread

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

[in] lpContext

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

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

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

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

Замечания

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

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

Требования

См. также

КОНТЕКСТ

функции отладки

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

Приостановка