Wow64SuspendThread 函数 (wow64apiset.h)

挂起指定的 WOW64 线程。

语法

DWORD Wow64SuspendThread(
  HANDLE hThread
);

参数

hThread

要挂起的线程的句柄。 句柄必须具有THREAD_SUSPEND_RESUME访问权限。 有关详细信息,请参阅 线程安全和访问权限

返回值

如果函数成功,则返回值为线程的上一个挂起计数;否则, (DWORD) -1。 若要获取扩展的错误信息,请使用 GetLastError 函数。

注解

如果函数成功,则挂起指定线程的执行,线程的挂起计数将递增。 挂起线程会导致线程停止执行用户模式 (应用程序) 代码。

此函数主要用于调试器。 它不用于线程同步。 如果调用线程尝试获取暂停的线程拥有的同步对象,则调用 Wow64SuspendThread (如互斥体或关键部分)可能会导致死锁。 为避免这种情况,应用程序中不是调试器的线程应向另一个线程发出信号,以暂停自身。 目标线程必须设计为watch此信号并做出适当的响应。

每个线程都有一个最大值为 MAXIMUM_SUSPEND_COUNT) 的暂停计数 (。 如果挂起计数大于零,则暂停线程;否则,线程不会挂起,并且符合执行条件。 调用 Wow64SuspendThread 会导致目标线程的挂起计数递增。 尝试递增超过最大暂停计数会导致错误而不递增计数。

ResumeThread 函数会减少挂起线程的挂起计数。

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

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 wow64apiset.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

ResumeThread