IHostTask::Alert 方法
要求主機喚醒目前 IHostTask 執行個體所代表的工作,以便中止工作。
語法
HRESULT Alert ();
傳回值
HRESULT | 描述 |
---|---|
S_OK | 此方法已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | 通用語言執行平台 (CLR) 尚未載入處理序,或 CLR 處於無法成功執行受控程式碼或處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL,則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
從使用者程式碼呼叫 Thread.Abort 時,或與目前 Thread 相關聯的 AppDomain 關機時,CLR 會呼叫 Alert
方法。 主機必須立即傳回,因為呼叫是以非同步方式進行。 如果主機無法立即針對工作發出警示,則必須在下一次進入可警示的狀態時喚醒。
注意
Alert
只會影響執行階段已傳遞 WAIT_ALERTABLE 的 WAIT_OPTION 值給聯結等方法的工作。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起可用