Methode ICLRTaskManager::CreateTask
Vraagt expliciet dat de Common Language Runtime (CLR) een nieuwe taak maakt.
Syntaxis
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parameters
pTask
[uit] Een aanwijzer naar het adres van een zojuist gemaakte ICLRTask of null als de taak niet kan worden gemaakt.
Retourwaarde
| HRESULT | Beschrijving |
|---|---|
| S_OK | De methode is geretourneerd. |
| HOST_E_CLRNOTAVAILABLE | De CLR is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
| HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
| HOST_E_NOT_OWNER | De beller is niet de eigenaar van het vergrendelingsslot. |
| HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte. |
| E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Er is onvoldoende geheugen beschikbaar om de aangevraagde resource toe te wijzen. |
Opmerkingen
De CLR maakt automatisch een nieuwe taak bij initialisatie, wanneer gebruikerscode een thread maakt met behulp van typen in de System.Threading naamruimte of wanneer de grootte van de threadgroep wordt vergroot. Er worden ook taken gemaakt wanneer onbeheerde code een beheerde functie aanroept.
CreateTask hiermee kan de host een expliciete aanvraag indienen om de CLR een nieuwe taak te laten maken. De host kan bijvoorbeeld deze methode aanroepen om gegevensstructuren vooraf te maken.
Belangrijk
De nieuwe taak wordt geretourneerd in een onderbroken status en blijft onderbroken totdat de host expliciet IHostTask::Start aanroept.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0
