ResumeThread

使執行緒的掛起時間計數減一。創建一個掛起的執行緒或者手動掛起一個執行緒後調用。調用該函式後執行緒不一定會立刻執行,而是由作業系統繼續調度,直到計數為0,系統為其分配資源時才開始執行。

基本介紹

  • 中文名:執行緒恢複函數
  • 外文名:ResumeThread
  • 來自:微軟
  • 屬性:編程使用
  • 頭檔案:WinBase.h
函式聲明,參數說明,返回值,注意事項,英文原文,微軟原文,

函式聲明

C++
dword winapi resumemethread(uuu in handle hthread);

參數說明

hthread[in]要重新啟動的執行緒的句柄。此句柄必須具有執行緒“掛起”恢復訪問許可權。有關詳細信息,請參閱執行緒安全和訪問許可權。

返回值

如果函式成功,返回值是執行緒的上一個掛起計數。
如果函式失敗,返回值為(dword)-1。要獲取擴展錯誤信息,請調用GetLastError。

注意事項

resumeThread函式檢查主題執行緒的掛起計數。如果掛起計數為零,則執行緒當前未掛起。否則,主題執行緒的掛起計數將減少。如果結果值為零,則繼續執行主題執行緒。
如果返回值為零,則指定的執行緒沒有掛起。如果返回值為1,則指定的執行緒已掛起,但已重新啟動。如果返回值大於1,則指定的執行緒仍將掛起。
請注意,在報告調試事件時,報告進程中的所有執行緒都將被凍結。調試程式需要使用suspendthread和resumethread函式來限制可以在進程內執行的執行緒集。通過掛起進程中除報告調試事件的執行緒外的所有執行緒,可以“單步”處理單個執行緒。如果掛起其他執行緒,則繼續操作不會釋放這些執行緒。

英文原文

Decrements a thread's suspend count. When the suspend count is decremented to zero, the execution of the thread is resumed.

微軟原文

ResumeThread Function
Decrements a thread's suspend count. When the suspend count is decremented to zero, the execution of the thread is resumed.

相關詞條

熱門詞條

聯絡我們