ICLRTask::SetTaskIdentifier 方法

發行項
08/12/2011

指示 Common Language Runtime (CLR) 將指定的識別項值與目前 ICLRTask 執行個體所表示的工作產生關聯。

HRESULT SetTaskIdentifier (
    [in] DWORD Asked
);

參數

Asked
[in] 要與目前 ICLRTask 執行個體所表示的工作產生關聯的 Common Language Runtime 唯一識別項。

傳回值

HRESULT	描述
S_OK	SetTaskIdentifier 已成功傳回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。
HOST_E_TIMEOUT	呼叫已逾時。
HOST_E_NOT_OWNER	呼叫端不具備鎖定功能。
HOST_E_ABANDONED	已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。
E_FAIL	發生未知的重大錯誤。當方法傳回 E_FAIL 時，便無法在處理序內使用 CLR。對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。

備註

主應用程式可以使識別項與工作產生關聯，以協助在偵錯環境中整合 CLR 和主應用程式。此識別項對於 CLR 不具任何意義。 CLR 會將它一直傳遞給偵錯工具應用程式。此偵錯工具可使用這個識別項，將 CLR 呼叫堆疊與主應用程式呼叫堆疊產生關聯，在偵錯工具的使用者介面中檢視時，便可以讓其各自的追蹤資訊統一。