IHostThreadPoolManager::QueueUserWorkItem 方法
将函数加入执行队列,并指定包含要由该函数使用的数据的对象。 该函数会在线程变为可用时执行。
语法
HRESULT QueueUserWorkItem (
[in] LPTHREAD_START_ROUTINE Function,
[in] PVOID Context,
[in] ULONG Flags
);
参数
Function
[in] 表示要执行的函数的函数指针。
Context
[in] 包含要由 Function
使用的数据的对象。
Flags
[in] 为控制执行的 Win32 QueueUserWorkItem
方法定义的标志值之一。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 QueueUserWorkItem 。 |
HOST_E_CLRNOTAVAILABLE | 公共语言运行时 (CLR) 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
QueueUserWorkItem
将工作项加入到线程池中的工作线程队列。 它的签名和参数类型与名称相同的相应 Win32 函数的签名和参数类型完全相同。 有关详细信息,请参阅 Windows 平台文档。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用