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)
程式庫 Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib
Dll Kernel32.dll;Windows Phone 8.1 上的 KernelBase.dll

另請參閱

OpenThread

處理序和執行緒函式

SuspendThread

暫停線程執行

執行緒