IHostTaskManager::CreateTask – metoda
Požaduje, aby hostitel vytvořil novou úlohu.
Syntaxe
HRESULT CreateTask (
[in] DWORD stacksize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
Parametry
stacksize
[v] Požadovaná velikost požadovaného zásobníku (v bajtech) nebo 0 (nula) pro výchozí velikost.
pStartAddress
[v] Ukazatel na funkci, která se má provést.
pParameter
[v] Ukazatel na uživatelská data, která mají být předána funkci, nebo null, pokud funkce nepřijímá žádné parametry.
ppTask
[out] Ukazatel na adresu instance IHostTask vytvořené hostitelem nebo null, pokud úlohu nelze vytvořit. Úloha zůstává v pozastaveném stavu, dokud není explicitně spuštěna voláním IHostTask::Start.
Návratová hodnota
| HRESULT | Description |
|---|---|
| S_OK | CreateTask úspěšně vráceno. |
| HOST_E_CLRNOTAVAILABLE | Modul CLR (Common Language Runtime) nebyl načten do procesu nebo 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, zatímco na ni čekalo blokované vlákno nebo vlákno. |
| E_FAIL | Došlo k neznámému závažnému selhání. Když metoda vrátí E_FAIL, clr již není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | K vytvoření požadované úlohy nebyl k dispozici dostatek paměti. |
Poznámky
Modul CLR volá CreateTask požadavek, aby hostitel vytvořil novou úlohu. Hostitel vrátí ukazatel rozhraní instance IHostTask . Vrácená úloha musí zůstat pozastavená, dokud není explicitně spuštěna voláním IHostTask::Start.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnutý jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0
