佇列函式執行,並指定包含該函式資料的物件。 當執行緒可用時,函式會執行。
語法
HRESULT QueueUserWorkItem (
[in] LPTHREAD_START_ROUTINE Function,
[in] PVOID Context,
[in] ULONG Flags
);
參數
Function [在]一個代表要執行函式的函式指標。
Context [在]一個包含 要被 Function使用的資料的物件。
Flags [在]其中一個旗標值,依照 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 起可用