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 | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
主机可以将标识符与任务相关联,以帮助将 CLR 和主机集成到调试环境中。 标识符对 CLR 没有意义。 CLR 会将它传递给调试器应用程序。 调试器可以使用此标识符将 CLR 调用堆栈与主机调用堆栈相关联,并启用它们各自的跟踪信息,以便在调试器的用户界面中查看时保持统一。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用