Wow64GetThreadContext 函数 (wow64apiset.h)

检索指定的 WOW64 线程的上下文。

语法

BOOL Wow64GetThreadContext(
  [in]      HANDLE         hThread,
  [in, out] PWOW64_CONTEXT lpContext
);

参数

[in] hThread

要检索其上下文的线程的句柄。 句柄必须具有 对线程THREAD_GET_CONTEXT 访问权限。 有关详细信息,请参阅 线程安全和访问权限

[in, out] lpContext

WOW64_CONTEXT结构。 调用方必须初始化此结构的 ContextFlags 成员。

返回值

如果函数成功,则返回值为非零。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,请调用 GetLastError

注解

此函数用于检索指定线程的线程上下文。 该函数根据 上下文结构的 ContextFlags 成员的值检索选择性上下文。 hThread 参数标识的线程通常正在调试,但该函数也可以在未调试线程时运行。

无法获取正在运行的线程的有效上下文。 使用 Wow64SuspendThread 函数在调用 Wow64GetThreadContext 之前暂停线程。

如果为当前线程调用 Wow64GetThreadContext ,则函数将成功返回;但是,返回的上下文无效。

此函数适用于 64 位应用程序。 32 位 Windows 不支持它;此类调用失败,并将最后一个错误代码设置为 ERROR_INVALID_FUNCTION。 32 位应用程序可以在 WOW64 线程上调用此函数;结果与调用 GetThreadContext 函数 相同。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1903
支持的最低服务器 Windows Server 版本 1903
标头 wow64apiset.h
图书馆 内核 32.lib
DLL Kernel32.dll

另请参阅

调试函数

GetThreadContext 函数

GetXStateFeaturesMask

WOW64_CONTEXT

Wow64SetThreadContext