将函数排队以供执行,并指定包含该函数要使用的数据的对象。 该函数在线程可用时执行。
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 起可用