ICLRTask::SetTaskIdentifier 方法
指示通用語言執行平台 (CLR) 將指定的識別碼值與目前 ICLRTask 執行個體所代表的工作產生關聯。
語法
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
參數
Asked
[in] 通用語言執行平台的唯一識別碼,可與目前 ICLRTask
執行個體所代表的工作產生關聯。
傳回值
HRESULT | 描述 |
---|---|
S_OK | SetTaskIdentifier 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | CLR 尚未載入處理序,或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL,則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
主機可以將識別碼與工作建立關聯,協助整合偵錯環境中的 CLR 與主機。 識別碼對 CLR 沒有意義。 CLR 會將其傳遞至偵錯工具應用程式。 偵錯工具可使用此識別碼來建立 CLR 呼叫堆疊與主機呼叫堆疊的關聯,並在偵錯工具的使用者介面中檢視時,使其各自的追蹤資訊獲得整合。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供