SuspendThread 函数 (processthreadsapi.h)
挂起指定的线程。
64 位应用程序可以使用 Wow64SuspendThread 函数挂起 WOW64 线程。
语法
DWORD SuspendThread(
[in] HANDLE hThread
);
参数
[in] hThread
要挂起的线程的句柄。
句柄必须具有 THREAD_SUSPEND_RESUME 访问权限。 有关详细信息，请参阅 线程安全和访问权限。
返回值
如果函数成功，则返回值为线程的上一个挂起计数;否则为 (DWORD) -1。 若要获取扩展的错误信息，请使用 GetLastError 函数。
注解
如果函数成功，则挂起指定线程的执行，线程的挂起计数将递增。 挂起线程会导致线程停止执行用户模式 (应用程序) 代码。
此函数主要用于调试器。 它不用于线程同步。 如果调用线程尝试获取暂停线程拥有的同步对象，在拥有同步对象的线程（如互斥体或关键部分）上调用 SuspendThread 可能会导致死锁。 为避免这种情况，应用程序中不是调试器的线程应向另一个线程发出信号，以暂停自身。 目标线程必须设计为watch此信号并做出适当的响应。
每个线程都有一个暂停计数 (，其最大值为 MAXIMUM_SUSPEND_COUNT) 。 如果挂起计数大于零，则暂停线程;否则，线程不会挂起，并且符合执行条件。 调用 SuspendThread 会导致目标线程的挂起计数递增。 尝试递增超过最大暂停计数会导致错误而不递增计数。
ResumeThread 函数会减少挂起线程的挂起计数。
Windows Phone 8.1：Windows Phone 8.1 及更高版本上的 Windows Phone 应用商店应用支持此函数。
Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | processthreadsapi.h (包括 Windows Vista 上的 Windows.h、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib |
| DLL | Kernel32.dll;Windows Phone 8.1 上的 KernelBase.dll |