ICLRTaskManager::GetCurrentTask-Methode

Artikel
08/10/2011

Ruft die ICLRTask-Instanz ab, die zurzeit auf dem Betriebssystemthread ausgeführt wird, von dem der Aufruf der Methode stammt.

HRESULT GetCurrentTask (
    [out] ICLRTask **ppTask
);

Parameter

ppTask
[out] Ein Zeiger auf die Adresse einer ICLRTask-Instanz, die zurzeit auf dem Betriebssystemthread ausgeführt wird, von dem der Aufruf stammt, oder NULL, wenn zurzeit keine Aufgabe auf diesem Thread ausgeführt wird.

Rückgabewert

HRESULT	Beschreibung
S_OK	Die Methode wurde 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 ICLRTask-Instanz, auf die der ppTask-Parameter zeigt, stellt die zurzeit ausgeführte Aufgabe für die CLR dar. Die ICLRTask-Instanz ist einer entsprechenden IHostTask-Instanz zugeordnet, die die Aufgabe für den Host darstellt.