Condividi tramite


Metodo ICLRTask::YieldTask

Richiede a Common Language Runtime (CLR) di sospendere l'attività rappresentata dall'istanza corrente di ICLRTask e di rendere disponibile il tempo processore ad altre attività.

HRESULT YieldTask ();

Valore restituito

HRESULT

Oggetto di descrizione

S_OK

YieldTask ha restituito correttamente un valore.

HOST_E_CLRNOTAVAILABLE

Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.

HOST_E_TIMEOUT

Timeout della chiamata.

HOST_E_NOT_OWNER

Il chiamante non è il proprietario del blocco.

HOST_E_ABANDONED

Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.

E_FAIL

Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Un host chiama YieldTask per richiedere le risorse del processore per altri processi o attività. Questo metodo ha come scopo principale quello di consentire al codice con esecuzione prolungata di cedere tempo di CPU. Common Language Runtime tenta di impostare l'attività rappresentata dall'istanza corrente di ICLRTask su uno stato in cui possa cedere tempo di elaborazione, senza tuttavia garantirne la riuscita.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Interfaccia ICLRTask

Interfaccia ICLRTaskManager

Interfaccia IHostTask

Interfaccia IHostTaskManager