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

另请参阅

OpenThread

进程和线程函数

ResumeThread

挂起线程执行

线程