IHostTask::SetPriority – metoda
Požaduje, aby hostitel upravil úroveň priority vlákna pro úlohu reprezentovanou aktuální instancí IHostTask .
Syntaxe
HRESULT SetPriority (
[in] int newPriority
);
Parametry
newPriority
[v] Celé číslo, které představuje požadovanou hodnotu priority vlákna pro úkol reprezentovaný aktuální IHostTask instancí.
Návratová hodnota
| HRESULT | Description |
|---|---|
| S_OK | SetPriority úspěšně vráceno. |
| HOST_E_CLRNOTAVAILABLE | Modul CLR (Common Language Runtime) nebyl načten do procesu nebo je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání. |
| HOST_E_TIMEOUT | Časový limit hovoru vypršel. |
| HOST_E_NOT_OWNER | Volající zámek nevlastní. |
| HOST_E_ABANDONED | Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno. |
| E_FAIL | Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
Poznámky
Vlákna mají přidělenou dobu zpracování pomocí systému kruhového dotazování, který je částečně založen na úrovni priority vlákna. SetPriority umožňuje modulu CLR nastavit úroveň priority vlákna pro aktuální úlohu. Podporují se následující newPriority hodnoty.
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL
CLR volá SetPriority , když je hodnota Thread.Priority změněna uživatelským kódem. Hostitel může definovat vlastní algoritmy pro přiřazení priority vlákna a může tento požadavek ignorovat.
Poznámka
SetPriority nehlásí, jestli se změnila úroveň priority vlákna. Zavolejte IHostTask::GetPriority k určení hodnoty úrovně priority vlákna úkolu.
Hodnoty úrovně priority vláken jsou definovány funkcí Win32 SetThreadPriority . Další informace o prioritě vláken najdete v dokumentaci k platformě Windows.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnuto jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0
