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 起可用

另请参阅