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

HOST_E_TIMEOUT

调用超时。

HOST_E_NOT_OWNER

调用方不拥有锁。

HOST_E_ABANDONED

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

E_FAIL

发生了未知的灾难性故障。 如果某方法返回 E_FAIL,CLR 便无法再在进程中使用。 对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

QueueUserWorkItem 将工作项排到线程池中的辅助线程队列中。 其签名和参数类型与同名的对应 Win32 函数完全相同。 有关更多信息,请参见 Windows 平台文档。

要求

**平台:**请参见 .NET Framework 系统要求

**头文件:**MSCorEE.h

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

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

请参见

参考

QueueUserWorkItem

ThreadPool

IHostThreadPoolManager 接口