ResumeThread 函数 (processthreadsapi.h)

递减线程的挂起计数。 当暂停计数减为零时,将恢复线程的执行。

语法

DWORD ResumeThread(
  [in] HANDLE hThread
);

参数

[in] hThread

要重启的线程的句柄。

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

返回值

如果函数成功,则返回值是线程的上一个挂起计数。

如果函数失败,则返回值 (DWORD) -1。 要获得更多的错误信息,请调用 GetLastError。

注解

ResumeThread 函数检查主题线程的挂起计数。 如果暂停计数为零,则线程当前未挂起。 否则,主题线程的挂起计数将递减。 如果生成的值为零,则继续执行主题线程。

如果返回值为零,则表示指定的线程未挂起。 如果返回值为 1,则表示指定的线程已暂停,但已重新启动。 如果返回值大于 1,则指定的线程仍挂起。

请注意,报告调试事件时,报告进程中的所有线程都会被冻结。 调试器应使用 SuspendThreadResumeThread 函数来限制可在进程中执行的线程集。 通过暂停进程中的所有线程(报告调试事件的线程除外),可以“单步执行”单个线程。 如果其他线程被挂起,则继续操作不会释放这些线程。

Windows Phone 8.1:Windows Phone 8.1 及更高版本上的 Windows Phone 应用商店应用支持此函数。

Windows 8.1Windows Server 2012 R2:Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。

要求

要求
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 processthreadsapi.h (包括 Windows Server 2003、Windows Vista、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

进程和线程函数

SuspendThread

挂起线程执行

线程