通过


IHostThreadPoolManager::QueueUserWorkItem 方法

将函数排队以供执行,并指定包含该函数要使用的数据的对象。 该函数在线程可用时执行。

Syntax

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

另见