ICLRTaskManager::CreateTask 方法
显式请求公共语言运行时 (CLR) 创建新任务。
语法
HRESULT CreateTask (
[out] ICLRTask **pTask
);
参数
pTask
[out] 指向新创建的 ICLRTask 的地址的指针，如果无法创建任务，则为 NULL。
返回值
| HRESULT | 说明 |
|---|---|
| S_OK | 该方法已成功返回。 |
| HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中，或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
| HOST_E_TIMEOUT | 调用超时。 |
| HOST_E_NOT_OWNER | 调用方未持有锁。 |
| HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。 |
| E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时，进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
| E_OUTOFMEMORY | 内存不足，无法分配请求资源。 |
备注
当用户代码使用 System.Threading 命名空间中的类型创建线程时，或线程池的大小增加时，CLR 会在初始化时自动创建一个新任务。 它还会在非托管代码调用托管函数时创建任务。
CreateTask 允许主机提出显式请求，要求 CLR 创建新任务。 例如，主机可以调用此方法来预初始化数据结构。
重要
新任务以挂起状态返回并保持挂起状态，直到主机显式调用 IHostTask::Start。
要求
平台：请参阅系统要求。
标头：MSCorEE.h
库：作为资源包含在 MSCorEE.dll 中
.NET Framework 版本：自 2.0 起可用
