Metodo ICLRTask::YieldTask
Richiede che Common Language Runtime (CLR) metta da parte l'attività rappresentata dall'istanza ICLRTask corrente e che il tempo del processore sia disponibile per altre attività.
Sintassi
HRESULT YieldTask ();
Valore restituito
| HRESULT | Descrizione |
|---|---|
| S_OK | YieldTask restituito correttamente. |
| HOST_E_CLRNOTAVAILABLE | CLR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non può eseguire codice gestito o elaborare correttamente la chiamata. |
| HOST_E_TIMEOUT | Timeout della chiamata. |
| HOST_E_NOT_OWNER | Il chiamante non possiede il blocco. |
| HOST_E_ABANDONED | Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata. |
| E_FAIL | Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE. |
Commenti
Un host chiama YieldTask per richiedere risorse del processore per altre attività o processi. Questo metodo è destinato principalmente a consentire al codice a esecuzione prolungata di rinunciare al tempo di CPU. Il runtime tenta di inserire l'attività rappresentata dall'istanza corrente ICLRTask in uno stato in cui può produrre il tempo di elaborazione, ma non garantisce l'esito positivo.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: Incluso come risorsa in MSCorEE.dll
Versioni di .NET Framework: Disponibile dalla versione 2.0
