Sdílet prostřednictvím

ICLRTask::YieldTask – metoda

  • Článek

Vyžaduje, aby modul CLR (Common Language Runtime) odložil bokem úlohu, kterou představuje aktuální instance ICLRTask , a zpřístupňuje čas procesoru jiným úlohám.

Syntax

HRESULT YieldTask ();

Návratová hodnota

HRESULT Description
S_OK YieldTask úspěšně vráceno.
HOST_E_CLRNOTAVAILABLE ClR nebyl načten do procesu nebo clr 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, zatímco na ni čekalo blokované vlákno nebo vlákno.
E_FAIL Došlo k neznámému závažnému selhání. Když metoda vrátí E_FAIL, clr již není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE.

Poznámky

Volání hostitele YieldTask k vyžádání prostředků procesoru pro jiné úlohy nebo procesy. Tato metoda je primárně určená k tomu, aby umožňovala dlouhotrvajícímu kódu, aby se uvolnil čas procesoru. Modul runtime se pokusí uvést úlohu, kterou představuje aktuální ICLRTask instance, do stavu, kdy může získat čas zpracování, ale neposkytuje záruku úspěchu.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

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

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

Viz také