Teilen über

IHostTaskManager::GetCurrentTask-Methode

  • Artikel

Ruft einen Schnittstellenzeiger auf die Aufgabe ab, die derzeit in dem Betriebssystemthread ausgeführt wird, aus dem dieser Aufruf erfolgt.

Syntax

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

Parameter

pTask
[out] Ein Zeiger auf die Adresse einer IHostTask-Instanz, die die derzeit ausgeführte Aufgabe repräsentiert oder NULL ist, 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 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.
HOST_E_INVALIDOPERATION GetCurrentTask wurde in einem Betriebssystemthread außerhalb der Kontrolle des Hosts aufgerufen.

Bemerkungen

Der Host kann auch den Parameter pTask auf NULL festlegen, um zu verhindern, dass eine nicht vom Host initiierte Aufgabe in die CLR gelangt.

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