請求主機調整目前 IHostTask 實例所代表任務的執行緒優先順序等級。
語法
HRESULT SetPriority (
[in] int newPriority
);
參數
newPriority [在]一個整數代表目前 IHostTask 實例所代表任務的請求執行緒優先權值。
傳回值
| HRESULT | 說明 |
|---|---|
| S_OK |
SetPriority 成功返回。 |
| HOST_E_CLRNOTAVAILABLE | 公共語言執行時（CLR）尚未載入程序，或 CLR 處於無法執行受管程式碼或成功處理呼叫的狀態。 |
| HOST_E_TIMEOUT | 通話時間過了。 |
| HOST_E_NOT_OWNER | 來電者並不擁有鎖具。 |
| HOST_E_ABANDONED | 事件在阻塞的執行緒或光纖等待時被取消。 |
| E_FAIL | 發生了一場未知的災難性故障。 當方法返回E_FAIL時，CLR 在程序中不再可用。 後續呼叫主機方法時會返回HOST_E_CLRNOTAVAILABLE。 |
備註
執行緒的處理時間是透過輪詢系統獲得的，部分依據執行緒的優先順序等級。
SetPriority 允許 CLR 為當前任務設定該執行緒優先權等級。
newPriority以下數值為支援。
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL
當 的Thread.Priority值被使用者程式碼修改時，CLR 會呼叫SetPriority。 主機可以自行定義執行緒優先權分配的演算法，且可自由忽略此請求。
備註
SetPriority 不會回報執行緒優先權等級是否被更改。 呼叫 IHostTask：：GetPriority 來確定任務執行緒優先權等級的值。
執行緒優先權等級的值由 Win32 SetThreadPriority 函式定義。 欲了解更多關於執行緒優先權的資訊，請參閱 Windows 平台文件。
要求
平台：請參閱系統需求。
標題： MSCorEE.h
圖書館： MSCorEE.dll 中納入資源
.NET Framework 版本： 自 2.0 起可用
