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 | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL,則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
QueueUserWorkItem
可將工作項目排入執行緒集區中背景工作執行緒的佇列中。 其簽章和參數類型與對應 Win32 函式的簽章和參數類型相同,其名稱相同。 如需詳細資訊,請參閱 Windows 平台文件。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起提供