Wow64SetThreadContext 函数 (wow64apiset.h)

设置指定的 WOW64 线程的上下文。

语法

BOOL Wow64SetThreadContext(
  [in] HANDLE              hThread,
  [in] const WOW64_CONTEXT *lpContext
);

参数

[in] hThread

要设置其上下文的线程的句柄。

[in] lpContext

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

返回值

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

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

注解

此函数允许根据 上下文结构的 ContextFlags 成员的值设置选择性上下文。 hThread 参数标识的线程句柄通常正在调试,但即使未调试函数,该函数也可以运行。

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

不要尝试为正在运行的线程设置上下文;结果不可预知。 使用 Wow64SuspendThread 函数在调用 Wow64SetThreadContext 之前暂停线程。

要求

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

另请参阅

调试函数

GetXStateFeaturesMask

SetThreadContext

SetXStateFeaturesMask

WOW64_CONTEXT

Wow64GetThreadContext