Methode IHostTaskManager::CreateTask

Artikel
05/10/2023

Vraagt de host om een nieuwe taak te maken.

Syntaxis

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

Parameters

stacksize
[in] De aangevraagde grootte, in bytes, van de aangevraagde stack of 0 (nul) voor de standaardgrootte.

pStartAddress
[in] Een aanwijzer naar de functie die de taak moet uitvoeren.

pParameter
[in] Een aanwijzer naar de gebruikersgegevens die moeten worden doorgegeven aan de functie, of null als de functie geen parameters heeft.

ppTask
[uit] Een verwijzing naar het adres van een IHostTask-exemplaar dat is gemaakt door de host, of null als de taak niet kan worden gemaakt. De taak blijft in een onderbroken status totdat deze expliciet wordt gestart door een aanroep naar IHostTask::Start.

Retourwaarde

HRESULT	Beschrijving
S_OK	`CreateTask` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Er was onvoldoende geheugen beschikbaar om de aangevraagde taak te maken.

Opmerkingen

De CLR roept CreateTask aan om de host te vragen een nieuwe taak te maken. De host retourneert een interfaceaanwijzer naar een IHostTask exemplaar. De geretourneerde taak moet onderbroken blijven totdat deze expliciet wordt gestart door een aanroep van IHostTask::Start.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via