通过

GetThreadContext 函数 （processthreadsapi.h）

  • 项目

检索指定线程的上下文。

64 位应用程序可以使用 Wow64GetThreadContext检索 WOW64 线程的上下文。

语法

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 应用]
目标平台 窗户
标头 processthreadsapi.h （包括 Windows.h）
库 Kernel32.lib
DLL Kernel32.dll

另请参阅