Функция 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 |
Нет |
|
Замечания по платформе |
Не имеется |