Поделиться через


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

Извлекает контекст указанного потока.

64-разрядное приложение может получить контекст потока WOW64 с помощью Wow64GetThreadContext.

Синтаксис

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

Параметры

[in] hThread

Дескриптор для потока, контекст которого требуется извлечь. Дескриптор должен иметь THREAD_GET_CONTEXT доступ к потоку. Дополнительные сведения см. в разделе Безопасность потоков и права доступа.

Windows XP или Windows Server 2003: Дескриптор также должен иметь доступ к THREAD_QUERY_INFORMATION .

[in, out] lpContext

Указатель на структуру CONTEXT (например , ARM64_NT_CONTEXT), получающую соответствующий контекст указанного потока. Значение элемента ContextFlags этой структуры указывает, какие части контекста потока извлекаются. Структура CONTEXT зависит от процессора. Сведения об определениях этих структур и требованиях к выравниванию см. в файле заголовка WinNT.h.

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

Если функция выполняется успешно, возвращается ненулевое значение.

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

Комментарии

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

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

При вызове GetThreadContext для текущего потока функция возвращается успешно; однако возвращаемый контекст недопустим.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header processthreadsapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также