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 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。
E_FAIL 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。
E_OUTOFMEMORY 内存不足,无法创建请求的任务。

注解

CLR 调用 CreateTask 来请求主机创建新任务。 主机返回指向 IHostTask 实例的接口指针。 返回的任务必须保持暂停状态,直到通过调用 IHostTask::Start 显式启动它。

要求

平台:请参阅系统要求

标头:MSCorEE.h

库:作为资源包含在 MSCorEE.dll 中

.NET Framework 版本:自 2.0 起可用

另请参阅