Methode IHostTask::SetPriority
Vraagt de host om het prioriteitsniveau van de thread aan te passen voor de taak die wordt vertegenwoordigd door het huidige IHostTask-exemplaar .
Syntaxis
HRESULT SetPriority (
[in] int newPriority
);
Parameters
newPriority
[in] Een geheel getal dat de aangevraagde threadprioriteitswaarde vertegenwoordigt voor de taak die wordt vertegenwoordigd door het huidige IHostTask exemplaar.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | SetPriority is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het slot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
Opmerkingen
Threads krijgen verwerkingstijd met behulp van een round robin-systeem dat deels is gebaseerd op het prioriteitsniveau van een thread. SetPriority hiermee kan de CLR het prioriteitsniveau van de thread instellen voor de huidige taak. De volgende newPriority waarden worden ondersteund.
THREAD_PRIORITY_ABOVE_NORMAL
THREAD_PRIORITY_BELOW_NORMAL
THREAD_PRIORITY_HIGHEST
THREAD_PRIORITY_IDLE
THREAD_PRIORITY_LOWEST
THREAD_PRIORITY_NORMAL
THREAD_PRIORITY_TIME_CRITICAL
De CLR roept aan SetPriority wanneer de waarde van de Thread.Priority wordt gewijzigd door gebruikerscode. Een host kan zijn eigen algoritmen definiëren voor het toewijzen van threadprioriteit en kan deze aanvraag negeren.
Notitie
SetPriority rapporteert niet of het prioriteitsniveau van de thread is gewijzigd. Roep IHostTask::GetPriority aan om de waarde van het threadprioriteitsniveau van de taak te bepalen.
Waarden voor threadprioriteitsniveaus worden gedefinieerd door de Win32-functie SetThreadPriority . Zie de documentatie voor het Windows-platform voor meer informatie over threadprioriteit.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
