Metodo ICLRTaskManager::CreateTask
Richiede in modo esplicito che Common Language Runtime (CLR) crei una nuova attività.
Sintassi
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parametri
pTask
[out] Puntatore all'indirizzo di un icLRTask appena creato o null, se non è stato possibile creare l'attività.
Valore restituito
| HRESULT | Descrizione |
|---|---|
| S_OK | Il metodo è stato restituito correttamente. |
| HOST_E_CLRNOTAVAILABLE | CLR non è stato caricato in un processo oppure CLR si trova in uno stato in cui non può 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 allocare la risorsa richiesta. |
Commenti
CLR crea automaticamente una nuova attività al momento dell'inizializzazione, quando il codice utente crea un thread usando i tipi nello System.Threading spazio dei nomi o quando le dimensioni del pool di thread vengono aumentate. Crea anche attività quando il codice non gestito effettua una chiamata a una funzione gestita.
CreateTask consente all'host di effettuare una richiesta esplicita che CLR crea una nuova attività. Ad esempio, l'host può richiamare questo metodo per preinitializzare le strutture di dati.
Importante
La nuova attività viene restituita in uno stato sospeso e rimane sospesa finché l'host non chiama in modo esplicito 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
