Dela via


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

Se även