ICLRTask::NeedsPriorityScheduling-Methode

Artikel
08/10/2011

Ruft einen Wert ab, der angibt, ob die aktuelle Aufgabe, die abgebrochen und entfernt wird, für eine Neuplanung als Aufgabe mit hoher Priorität markiert werden muss.

HRESULT NeedsPriorityScheduling (
    [out] BOOL *pbNeedsPriorityScheduling
);

Parameter

pbNeedsPriorityRescheduling
[out] true, wenn der Host so schnell wie möglich versuchen soll, die aktuelle Aufgabeninstanz neu zu planen; andernfalls false.

Rückgabewert

HRESULT	Beschreibungen
S_OK	NeedsPriorityRescheduling erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (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	Der Aufruf hat das Zeitlimit ü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

Die CLR legt den Wert von pbNeedsPriorityScheduling auf true fest, um eine Neuplanung mit hoher Priorität anzugeben, wenn für die Aufgabe in Kürze eine Garbage Collection durchgeführt wird. Der Host kann die Aufgabe so schnell neu planen und mögliche Verzögerungen bei der Garbage Collection minimieren, sodass Host und Common Language Runtime bei der Bewahrung von Speicherressourcen kooperieren können.