ICLRTaskManager::CreateTask – metoda
Explicitně požaduje, aby modul CLR (Common Language Runtime) vytvořil novou úlohu.
Syntaxe
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parametry
pTask
[out] Ukazatel na adresu nově vytvořeného objektu ICLRTask nebo null, pokud úkol nelze vytvořit.
Návratová hodnota
| HRESULT | Description |
|---|---|
| S_OK | Metoda se úspěšně vrátila. |
| HOST_E_CLRNOTAVAILABLE | ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání. |
| HOST_E_TIMEOUT | Časový limit hovoru vypršel. |
| HOST_E_NOT_OWNER | Volající zámek nevlastní. |
| HOST_E_ABANDONED | Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno. |
| E_FAIL | Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | K přidělení požadovaného prostředku není k dispozici dostatek paměti. |
Poznámky
CLR vytvoří novou úlohu automaticky při inicializaci, když uživatelský kód vytvoří vlákno pomocí typů v System.Threading oboru názvů nebo když se zvětší velikost fondu vláken. Také vytváří úlohy, když nespravovaný kód provede volání spravované funkce.
CreateTask umožňuje hostiteli vytvořit explicitní požadavek, aby CLR vytvořil novou úlohu. Hostitel může například vyvolat tuto metodu k preinicializaci datových struktur.
Důležité
Nová úloha se vrátí v pozastaveném stavu a zůstane pozastavená, dokud hostitel explicitně nevolá IHostTask::Start.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnuto jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0
