Metodo ICLRTaskManager::CreateTask

Articolo
08/11/2011

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.