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) 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

事件在被阻止的线程或纤程正在等待它时被取消。

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 接口