检索指定的 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 |