ICLRTask::SetTaskIdentifier 方法
指示公共语言运行时 (CLR) 将指定的标识符值与当前 ICLRTask 实例表示的任务相关联。
HRESULT SetTaskIdentifier (
[in] DWORD Asked
);
参数
- Asked
[in] 要与当前 ICLRTask 实例表示的任务关联的公共语言运行时的唯一标识符。
返回值
HRESULT |
说明 |
|---|---|
S_OK |
SetTaskIdentifier 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。 |
HOST_E_TIMEOUT |
调用超时。 |
HOST_E_NOT_OWNER |
调用方不拥有锁。 |
HOST_E_ABANDONED |
事件在被阻止的线程或纤程正在等待它时被取消。 |
E_FAIL |
发生了未知的灾难性故障。 如果某方法返回 E_FAIL，CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。 |
备注
宿主可以将标识符与任务关联起来，以便帮助在调试环境下集成 CLR 和宿主。 此标识符对于 CLR 没有任何意义。 CLR 仅将它传递给调试器应用程序。 调试器可以使用此标识符将 CLR 调用堆栈与宿主调用堆栈关联起来，这样在调试器用户界面中查看时就可以使它们各自的跟踪信息保持统一。
要求
**平台：**请参见 .NET Framework 系统要求。
**头文件：**MSCorEE.h
**库：**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0