IHostTask::SetPriority – metoda

Vyž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 hodnotu priority požadovaného vlákna pro úlohu reprezentovanou aktuální IHostTask instancí.

Návratová hodnota

HRESULT Description
S_OK SetPriority byla úspěšně vrácena.
HOST_E_CLRNOTAVAILABLE Modul CLR (Common Language Runtime) nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže úspěšně spustit spravovaný kód nebo proces volání.
HOST_E_TIMEOUT Vypršel časový limit hovoru.
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é katastrofické chybě. Když metoda vrátí E_FAIL, CLR již není možné použít v rámci procesu. Následná volání metod hostování vrací HOST_E_CLRNOTAVAILABLE.

Poznámky

Vlákna mají udě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 CLR nastavit danou ú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 změněna Thread.Priority 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í, zda byla změněna úroveň priority vlákna. Volání IHostTask::GetPriority určit hodnotu úrovně priority vlákna úkolu.

Hodnoty na úrovni priority vlákna jsou definovány funkcí Win32 SetThreadPriority . Další informace o prioritě vlákna najdete v dokumentaci k platformě Windows.

Požadavky

Platformy: Viz požadavky na systém.

Záhlaví: MSCorEE.h

Knihovna: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také

  • Last updated on