ICLRTaskManager::CreateTask, metod
Begär uttryckligen att CLR (Common Language Runtime) skapar en ny uppgift.
Syntax
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parametrar
pTask
[ut] En pekare till adressen till en nyligen skapad ICLRTask, eller null, om uppgiften inte kunde skapas.
Returvärde
HRESULT | Description |
---|---|
S_OK | Metoden returnerades. |
HOST_E_CLRNOTAVAILABLE | CLR har inte lästs in i en process, eller så är CLR i ett tillstånd där den inte kan köra hanterad kod eller bearbeta anropet. |
HOST_E_TIMEOUT | Tidsgränsen för samtalet överst. |
HOST_E_NOT_OWNER | Anroparen äger inte låset. |
HOST_E_ABANDONED | En händelse avbröts medan en blockerad tråd eller fiber väntade på den. |
E_FAIL | Ett okänt oåterkalleligt fel inträffade. När en metod returnerar E_FAIL kan CLR inte längre användas i processen. Efterföljande anrop till värdmetoder returnerar HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | Det finns inte tillräckligt med minne för att allokera den begärda resursen. |
Kommentarer
CLR skapar en ny uppgift automatiskt vid initiering, när användarkod skapar en tråd med hjälp av typer i System.Threading namnområdet eller när storleken på trådpoolen ökar. Den skapar också uppgifter när ohanterad kod gör ett anrop till en hanterad funktion.
CreateTask
tillåter värden att uttryckligen begära att CLR skapar en ny uppgift. Värden kan till exempel anropa den här metoden för att förinitiera datastrukturer.
Viktigt
Den nya aktiviteten returneras i pausat tillstånd och förblir pausad tills värden uttryckligen anropar IHostTask::Start.
Krav
Plattformar: Se Systemkrav.
Huvudet: MSCorEE.h
Bibliotek: Ingår som en resurs i MSCorEE.dll
.NET Framework versioner: Tillgänglig sedan 2.0