ICLRTask::YieldTask-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Fordert an, dass die Common Language Runtime (CLR) die von der aktuellen ICLRTask-Instanz dargestellte Aufgabe zurückstellt und die Prozessorzeit anderen Aufgaben zur Verfügung stellt.

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 befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Das Zeitlimit für den Aufruf wurde überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Ein Host ruft YieldTask auf, um Prozessor-Ressourcen für andere Aufgaben oder Prozesse anzufordern. Diese Methode ermöglicht in erster Linie, CPU-Zeit von Code mit langer Laufzeit abzuziehen. Die Laufzeit versucht, die durch die aktuelle ICLRTask-Instanz dargestellte Aufgabe in einen Zustand zu versetzen, in dem Verarbeitungszeit abgezogen werden kann. Der Erfolg ist jedoch nicht garantiert.