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