IHostTaskManager::GetCurrentTask-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Ruft einen Schnittstellenzeiger auf die Aufgabe ab, die aktuell im Betriebssystemthread ausgeführt wird, aus dem der Aufruf vorgenommen wurde.

HRESULT GetCurrentTask (
    [out] IHostTask **pTask
);

Parameter

pTask
[out] Ein Zeiger auf die Adresse einer IHostTask-Instanz, die die aktuell ausgeführte Aufgabe darstellt; oder NULL, wenn derzeit keine Aufgabe ausgeführt wird.

Rückgabewert

HRESULT	Beschreibung
S_OK	GetCurrentTask 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	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.
HOST_E_INVALIDOPERATION	GetCurrentTask wurde für einen Betriebssystemthread aufgerufen, der vom Host nicht gesteuert wird.

Hinweise

Der Host kann den Parameter pTask auch auf NULL festlegen, um die Ausführung einer Aufgabe zu verhindern, die nicht durch den Start der CLR initialisiert wurde.