共用方式為


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

Common Language Runtime (CLR) 尚未載入至處理序中,或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。

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 的呼叫所明確啟動之前,都必須維持在已暫止的狀態。

需求

**平台:**請參閱 .NET Framework 系統需求

**標頭:**MSCorEE.h

程式庫:包含做為 MSCorEE.dll 中的資源

**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

請參閱

參考

ICLRTask 介面

ICLRTaskManager 介面

IHostTask 介面

IHostTaskManager 介面