Функция SetThreadContext

Функция SetThreadContext устанавливает контекст для заданного потока.

Синтаксис

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

Параметры

hThread

[in] Дескриптор потока, контекст которого должен установиться. Дескриптор должен иметь право доступа к потоку THREAD_SET_CONTEXT. Дополнительную информацию, см. в статье Защита потока и права доступа.

lpContext

[in] Указатель на структуру CONTEXT, содержащую контекст, который устанавливается в заданном потоке. Значение члена структуры ContextFlags этой структуры определяет, какие части контекста потока устанавливаются. Некоторые значения в структуре CONTEXT, которые не могут быть определены, устанавливаются без объявления в правильное значение. Они включают в себя биты состояния регистров центрального процессора, которые устанавливают привилегированный процессорный режим, глобальную переменную, включающую в работу биты в регистре отладки программы и другие состояния, которые должны управляться операционной системой.

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

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

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

Замечания

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

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

Смотри также

Обзор Основы отладки, Функции, используемые при отладке CONTEXT, GetThreadContext SuspendThread

Размещение и совместимость SetThreadContext

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT  Workstation

Да

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да 
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL kernel32.dll
 Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

Нет

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz