Condividi tramite


Metodo ICLRTaskManager::CreateTask

Richiede esplicitamente a Common Language Runtime (CLR) la creazione di una nuova attività.

HRESULT CreateTask (
    [out] ICLRTask **pTask
);

Parametri

  • pTask
    [out] Puntatore all'indirizzo di una ICLRTask appena creata oppure null se non è stato possibile creare l’attività.

Valore restituito

HRESULT

Descrizione

S_OK

Il metodo ha restituito correttamente un valore.

HOST_E_CLRNOTAVAILABLE

Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.

HOST_E_TIMEOUT

Timeout della chiamata.

HOST_E_NOT_OWNER

Il chiamante non è il proprietario del blocco.

HOST_E_ABANDONED

Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.

E_FAIL

Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

E_OUTOFMEMORY

Memoria insufficiente per l'allocazione della risorsa richiesta.

Note

CLR crea una nuova attività automaticamente al momento dell'inizializzazione, quando il codice utente crea un thread utilizzando dei tipi nello spazio dei nomi System.Threading oppure quando la dimensione del pool di thread è aumentata. Delle attività vengono inoltre create quando il codice non gestito effettua una chiamata a una funzione gestita.

CreateTask consente all'host di richiedere esplicitamente a CLR di creare una nuova attività. L'host può ad esempio richiamare questo metodo per preinizializzare strutture di dati.

Nota importanteImportante

La nuova attività viene restituita in uno stato sospeso e rimane in questo stato fino a quando l'host non chiama esplicitamente IHostTask::Start.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

Interfaccia ICLRTask

Interfaccia ICLRTaskManager

Interfaccia IHostTask

Interfaccia IHostTaskManager