Sdílet prostřednictvím

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

Viz také

  • Last updated on