Delen via

Methode ICLRTask::YieldTask

  • Artikel

Vraagt dat de Common Language Runtime (CLR) de taak die het huidige ICLRTask-exemplaar vertegenwoordigt, opzij zet en de processortijd beschikbaar maakt voor andere taken.

Syntax

HRESULT YieldTask ();

Retourwaarde

HRESULT Beschrijving
S_OK YieldTask is geretourneerd.
HOST_E_CLRNOTAVAILABLE De 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

Een host roept YieldTask aan om processorresources aan te vragen voor andere taken of processen. Deze methode is voornamelijk bedoeld om langlopende code cpu-tijd te laten opgeven. De runtime probeert de taak die het huidige ICLRTask exemplaar vertegenwoordigt, in een status te plaatsen waarin deze verwerkingstijd kan opleveren, maar biedt geen garantie voor succes.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook