ICLRTaskManager::CreateTask-Methode
Fordert explizit an, dass die Common Language Runtime (CLR) einen neuen Task erstellt.
Syntax
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parameter
pTask
[out] Ein Zeiger auf die Adresse eines neu erstellten ICLRTask oder NULL, wenn der Task nicht erstellt werden konnte.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Die Methode wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die 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. |
| E_OUTOFMEMORY | Es ist nicht genügend Arbeitsspeicher verfügbar, um die angeforderte Ressource zuzuordnen. |
Bemerkungen
Die CLR erstellt automatisch bei der Initialisierung einen neuen Task, wenn der Benutzercode einen Thread mithilfe von Typen im System.Threading-Namespace erstellt oder wenn die Größe des Threadpools erhöht wird. Außerdem werden Tasks erstellt, wenn nicht verwalteter Code eine verwaltete Funktion aufruft.
CreateTask ermöglicht dem Host, eine explizite Anforderung zu stellen, dass die CLR einen neuen Task erstellt. Beispielsweise kann der Host diese Methode aufrufen, um Datenstrukturen vorab zu initialisieren.
Wichtig
Der neue Task wird in einem angehaltenen Zustand zurückgegeben und bleibt angehalten, bis der Host IHostTask::Start explizit aufruft.
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.
