IHostTask::SetPriority — Metoda
Żąda, aby host dostosować poziom priorytetu wątku dla zadania reprezentowanego przez bieżące wystąpienie IHostTask .
Składnia
HRESULT SetPriority (
[in] int newPriority
);
Parametry
newPriority
[w] Liczba całkowita reprezentująca żądaną wartość priorytetu wątku dla zadania reprezentowanego przez bieżące IHostTask wystąpienie.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | SetPriority zwrócono pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
Uwagi
Wątki są przyznawane czas przetwarzania przy użyciu systemu działania okrężnego, który jest częściowo oparty na poziomie priorytetu wątku. SetPriority umożliwia clR ustawienie tego poziomu priorytetu wątku dla bieżącego zadania. Obsługiwane są następujące newPriority wartości.
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 wywołuje wywołanie SetPriority , gdy wartość elementu Thread.Priority jest modyfikowana przez kod użytkownika. Host może zdefiniować własne algorytmy przypisania priorytetu wątku i może zignorować to żądanie.
Uwaga
SetPriority nie zgłasza, czy poziom priorytetu wątku został zmieniony. Wywołaj metodę IHostTask::GetPriority , aby określić wartość poziomu priorytetu wątku zadania.
Wartości na poziomie priorytetu wątku są definiowane przez funkcję Win32 SetThreadPriority . Aby uzyskać więcej informacji na temat priorytetu wątku, zobacz dokumentację platformy systemu Windows.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
.NET Framework wersje: dostępne od wersji 2.0
