Metodo IHostTaskManager::CreateTask

Articolo
05/10/2023

Richiede che l'host crei una nuova attività.

Sintassi

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

Parametri

stacksize
[in] Dimensioni richieste, in byte, dello stack richiesto o 0 (zero) per le dimensioni predefinite.

pStartAddress
[in] Un puntatore alla funzione che l'attività deve essere eseguita.

pParameter
[in] Puntatore ai dati utente da passare alla funzione oppure Null se la funzione non accetta parametri.

ppTask
[out] Puntatore all'indirizzo di un'istanza IHostTask creata dall'host oppure Null se l'attività non può essere creata. L'attività rimane in uno stato sospeso fino a quando non viene avviata in modo esplicito da una chiamata a IHostTask::Start.

Valore restituito

HRESULT	Descrizione
S_OK	`CreateTask` restituito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non possiede il blocco.
HOST_E_ABANDONED	Un evento è stato annullato durante l'attesa di un thread o di una fibra bloccata.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Quando un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Memoria insufficiente per creare l'attività richiesta.

Commenti

CLR chiama CreateTask per richiedere che l'host crei una nuova attività. L'host restituisce un puntatore all'interfaccia a un'istanza IHostTask di . L'attività restituita deve rimanere sospesa finché non viene avviata in modo esplicito da una chiamata a IHostTask::Start.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 2.0

Condividi tramite