Функция GetThreadContext


Функция 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, SetThreadContextSuspendThread

Размещение и совместимость 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

Нет

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

Не имеется

 

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

Hosted by uCoz