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

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

  • Статья

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

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

Синтаксис

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

Параметры

[in] hThread

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

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]
целевая платформа Виндоус
заголовка processthreadsapi.h (include Windows.h)
библиотеки Kernel32.lib
DLL Kernel32.dll

См. также