ICLRTask::YieldTask-Methode
Fordert an, dass die Common Language Runtime (CLR) die Aufgabe beiseite legt, die die aktuelle ICLRTask-Instanz darstellt, und die Prozessorzeit für andere Aufgaben verfügbar macht.
Syntax
HRESULT YieldTask ();
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | YieldTask wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
| HOST_E_TIMEOUT | Timeout des Aufrufs. |
| HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
| HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
| E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Bemerkungen
Ein Host ruft YieldTask auf, um Prozessorressourcen für andere Aufgaben oder Prozesse anzufordern. Diese Methode ist in erster Linie dafür vorgesehen, dass Code mit langer Ausführungszeit die CPU-Zeit freigeben kann. Die Laufzeit versucht, die Aufgabe, die die aktuelle ICLRTask-Instanz darstellt, in einen Zustand zu versetzen, in dem sie Verarbeitungszeit nutzen kann, übernimmt jedoch keine Garantie für den Erfolg.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.
