Megosztás a következőn keresztül:

ICLRTaskManager::CreateTask metódus

  • Cikk

Kifejezetten kéri, hogy a közös nyelvi futtatókörnyezet (CLR) hozzon létre egy új feladatot.

Szintaxis

HRESULT CreateTask (  
    [out] ICLRTask **pTask  
);

Paraméterek

pTask
[kifelé] Mutató egy újonnan létrehozott ICLRTask címére vagy null értékre, ha a feladat nem hozható létre.

Visszatérési érték

HRESULT Description
S_OK A metódus sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várt rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza.
E_OUTOFMEMORY Nincs elég memória a kért erőforrás lefoglalásához.

Megjegyzések

A CLR automatikusan létrehoz egy új feladatot az inicializáláskor, amikor a felhasználói kód típusokkal hoz létre szálat a System.Threading névtérben, vagy ha a szálkészlet mérete megnő. Akkor is létrehoz feladatokat, ha a nem felügyelt kód meghív egy felügyelt függvényt.

CreateTask lehetővé teszi, hogy a gazdagép explicit kérést küldjön, amely szerint a CLR új feladatot hoz létre. A gazdagép például meghívhatja ezt a metódust az adatstruktúrák előzetes iniializálásához.

Fontos

Az új feladat felfüggesztett állapotban lesz visszaadva, és felfüggesztve marad, amíg a gazdagép explicit módon nem hívja meg az IHostTask::Start parancsot.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még