Metodo IHostTaskManager::CreateTask

Articolo
08/11/2011

Richiede all'host di creare una nuova attività.

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

Parametri

stacksize
[in] La dimensione richiesta, in byte, dello stack richiesto oppure 0 (zero) per la dimensione predefinita.
pStartAddress
[in] Puntatore alla funzione che deve essere eseguita dall'attività.
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 di 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 esplicitamente da una chiamata al metodo IHostTask::Start.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	CreateTask 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 la creazione dell'attività richiesta.

Note

Common Language Runtime chiama il metodo CreateTask per richiedere la creazione di una nuova attività da parte dell'host. L'host restituisce un puntatore a interfaccia a un'istanza di IHostTask. L'attività restituita deve rimanere sospesa fino a quando non verrà avviata esplicitamente da una chiamata a IHostTask::Start.