IHostTaskManager::CreateTask-metod

Artikel
04/08/2023

Begär att värden skapar en ny uppgift.

Syntax

HRESULT CreateTask (  
    [in]  DWORD stacksize,
    [in]  LPTHREAD_START_ROUTINE pStartAddress,  
    [in]  PVOID pParameter,  
    [out] IHostTask **ppTask  
);

Parametrar

stacksize
[i] Den begärda storleken i byte för den begärda stacken eller 0 (noll) för standardstorleken.

pStartAddress
[i] En pekare till funktionen som uppgiften ska köra.

pParameter
[i] En pekare till användardata som ska skickas till funktionen eller null om funktionen inte tar några parametrar.

ppTask
[ut] En pekare till adressen för en IHostTask-instans som skapats av värden eller null om uppgiften inte kan skapas. Uppgiften förblir i ett pausat tillstånd tills den uttryckligen startas av ett anrop till IHostTask::Start.

Returvärde

HRESULT	Description
S_OK	`CreateTask` returnerades korrekt.
HOST_E_CLRNOTAVAILABLE	CLR (Common Language Runtime) 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	Samtalets tidsgräns ö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 fanns inte tillräckligt med minne för att skapa den begärda aktiviteten.

Kommentarer

CLR anropar CreateTask för att begära att värden skapar en ny uppgift. Värden returnerar en gränssnittspekare till en IHostTask instans. Den returnerade aktiviteten måste vara pausad tills den uttryckligen startas av ett anrop till 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

Dela via