ICLRTaskManager::CreateTask 方法
明確要求 Common Language Runtime (CLR) 建立新的工作。
HRESULT CreateTask (
[out] ICLRTask **pTask
);
參數
- pTask
[out] 新建立之 ICLRTask 的位址指標，如果無法建立此工作，則為 null。
傳回值
HRESULT |
描述 |
|---|---|
S_OK |
成功傳回方法。 |
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。 |
E_OUTOFMEMORY |
可用的記憶體不足，無法配置所要求的資源。 |
備註
當使用者程式碼使用 System.Threading 命名空間內的型別建立執行緒，或是執行緒集區的大小增加時，CLR 會在初始化之後自動建立新的工作。 當 Unmanaged 程式碼呼叫 Managed 函式時，它也會建立工作。
CreateTask 可讓主應用程式明確要求 CLR 建立新的工作。 例如，主應用程式可以叫用這個方法，先行初始化資料結構。
.gif "重要事項") 重要事項 |
|---|
新的工作會在暫止狀態中傳回，而且在主應用程式明確呼叫 IHostTask::Start 之前，都會維持在暫止的狀態。 |
需求
**平台：**請參閱 .NET Framework 系統需求。
**標頭：**MSCorEE.h
程式庫：包含做為 MSCorEE.dll 中的資源
**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0