Udostępnij za pośrednictwem

ICLRTask::YieldTask — Metoda

  • Artykuł

Żąda, aby środowisko uruchomieniowe języka wspólnego (CLR) odkładało zadanie reprezentowane przez bieżące wystąpienie ICLRTask i udostępniało czas procesora innym zadaniom.

Składnia

HRESULT YieldTask ();

Wartość zwracana

HRESULT Opis
S_OK YieldTask zwrócone pomyślnie.
HOST_E_CLRNOTAVAILABLE ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie.
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 jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

Host wywołuje żądanie YieldTask zasobów procesora dla innych zadań lub procesów. Ta metoda jest przeznaczona głównie do umożliwienia długotrwałego kodu rezygnacji z czasu procesora CPU. Środowisko uruchomieniowe próbuje umieścić zadanie, które bieżące ICLRTask wystąpienie reprezentuje w stanie, w którym może przynieść czas przetwarzania, ale nie gwarantuje powodzenia.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też