Teilen über

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.

Siehe auch

  • Last updated on