Функция GetThreadContext извлекает данные о контексте заданного потока.
Синтаксис
BOOL GetThreadContext( HANDLE hThread, LPCONTEXT lpContext ); |
Параметры
hThread
[in] Дескриптор потока, контекст которого должен извлечься. Дескриптор должен иметь доступ к потоку THREAD_GET_CONTEXT. Дополнительную информацию, см. в статье Защита потока и права доступа.WOW64: Дескриптор должен также иметь и доступ THREAD_QUERY_INFORMATION.
lpContext
[in, out] Указатель на структуру CONTEXT, которая получает соответствующий контекст заданного потока. Значение члена структуры ContextFlags этой структуры определяет, какие части контекста потока извлекаются. Структура CONTEXT высоко специфична для компьютера. В настоящее время, имеются структуры CONTEXT, определяемые для процессоров Intel, MIPS, Alpha и PowerPC. Обратитесь к заголовочному файлу WinNt.h за описаниями этих структур.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение не нуль.
Если функция завершается ошибкой, возвращаемое значение равняется нулю. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция GetThreadContext используется, чтобы извлечь данные о контексте заданного потока. Функция дает возможность отбирать контекст, который будет извлекаться основываясь на значении члена структуры ContextFlags структуры CONTEXT. Дескриптор потока, идентифицированный параметром hThread обычно отлаживаемый, но функция может также работать и тогда, когда отладки он не делает.
Вы не можете получить допустимый контекст для запущенного потока. Используйте функцию SuspendThread, чтобы приостановить поток перед вызовом GetThreadContext.
Если Вы вызываете GetThreadContext для текущего потока, функция возвращает значения успешно; однако, возвращенный контекст не допустим.
Смотри также
Обзор Основы отладки, Функции, используемые при отладке, CONTEXT, SetThreadContext, SuspendThread
|
Размещение и совместимость GetThreadContext |
||
| К |
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 |
Нет |
|
| Замечания по платформе |
Не имеется |
|