ICLRTaskManager::CreateTask 方法
明確要求 Common Language Runtime (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 | 封鎖的執行緒或 Fiber 在其上等候時，事件遭到取消。 |
| E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL，則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
| E_OUTOFMEMORY | 記憶體不足，無法配置所要求的資源。 |
備註
CLR 會在下列情況自動建立新工作：初始化時、當使用者程式碼使用 System.Threading 命名空間中的類型建立執行緒時，或執行緒集區的大小增加時。 當非受控程式碼呼叫受控語言函式時也會建立工作。
CreateTask 可讓主機明確要求 CLR 建立新工作。 例如，主機可以叫用這個方法來預先初始化資料結構。
重要
新工作會以暫停狀態傳回，並維持暫停狀態，直到主機明確呼叫 IHostTask::Start 為止。
規格需求
平台：請參閱系統需求。
標題： MSCorEE.h
程式庫：包含作為 MSCorEE.dll 中的資源
.NET Framework版本：自 2.0 起提供
