IHostTaskManager::CreateTask 方法
要求主機建立新工作。
語法
HRESULT CreateTask (
[in] DWORD stacksize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
參數
stacksize
[in] 所要求堆疊的所要求大小 (以位元組為單位),預設大小則為 0 (零)。
pStartAddress
[in] 工作要執行之函式的指標。
pParameter
[in] 要傳遞至函式之使用者資料的指標,如果函式不採用任何參數,則為 null。
ppTask
[out] 主機所建立 IHostTask 執行個體位址的指標,如果無法建立工作,則為 null。 工作會保持暫止狀態,直到透過呼叫 IHostTask::Start 而受到明確啟動為止。
傳回值
HRESULT | 描述 |
---|---|
S_OK | CreateTask 已成功傳回。 |
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 會呼叫 CreateTask
來要求主機建立新工作。 主機會傳回 IHostTask
執行個體的介面指標。 傳回的工作必須保持暫止狀態,直到透過呼叫 IHostTask::Start
而受到明確啟動為止。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供