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 |
Common Language Runtime (CLR) 尚未載入至處理序中,或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。 |
HOST_E_TIMEOUT |
呼叫已逾時。 |
HOST_E_NOT_OWNER |
呼叫端不具備鎖定功能。 |
HOST_E_ABANDONED |
已封鎖執行緒或 Fiber 在等候事件時,該事件已遭取消。 |
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