Dela via


ICLRTask::YieldTask, metod

Begäranden om att CLR (Common Language Runtime) lägger åt sidan uppgiften som den aktuella ICLRTask-instansen representerar och gör processortiden tillgänglig för andra uppgifter.

Syntax

HRESULT YieldTask ();  

Returvärde

HRESULT Description
S_OK YieldTask returnerades.
HOST_E_CLRNOTAVAILABLE CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet.
HOST_E_TIMEOUT Tidsgränsen för samtalet överst.
HOST_E_NOT_OWNER Anroparen äger inte låset.
HOST_E_ABANDONED En händelse avbröts medan en blockerad tråd eller fiber väntade på den.
E_FAIL Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE.

Kommentarer

En värd anropar YieldTask för att begära processorresurser för andra uppgifter eller processer. Den här metoden är främst avsedd att tillåta tidskrävande kod för att ge upp CPU-tid. Körningen försöker placera den uppgift som den aktuella ICLRTask instansen representerar i ett tillstånd där den kan ge bearbetningstid, men garanterar inte att den lyckas.

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: Ingår som en resurs i MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 2.0

Se även