ResumeThread 函式 (processthreadsapi.h)
遞減線程的暫停計數。 當暫停計數遞減為零時,會繼續執行線程。
語法
DWORD ResumeThread(
[in] HANDLE hThread
);
參數
[in] hThread
要重新啟動之線程的句柄。
此句柄必須具有THREAD_SUSPEND_RESUME訪問許可權。 如需詳細資訊,請參閱 線程安全性和訪問許可權。
傳回值
如果函式成功,傳回值就是線程先前的暫停計數。
如果函式失敗,傳回值會 (DWORD) -1。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
ResumeThread 函式會檢查主旨線程的暫停計數。 如果暫停計數為零,則線程目前不會暫停。 否則,主旨線程的暫停計數會遞減。 如果產生的值為零,則會繼續執行主旨線程。
如果傳回值為零,則指定的線程並未暫停。 如果傳回值為 1,則指定的線程已暫停,但已重新啟動。 如果傳回值大於 1,則指定的線程仍會暫停。
請注意,在報告偵錯事件時,報告進程內的所有線程都會凍結。 調試程式預期會使用 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 Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2) |
程式庫 | Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib |
Dll | Kernel32.dll;Windows Phone 8.1 上的 KernelBase.dll |