Método ICLRTaskManager::CreateTask
Solicita explicitamente que o runtime de linguagem comum (CLR) crie uma nova tarefa.
Sintaxe
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parâmetros
pTask
[fora] Um ponteiro para o endereço de um ICLRTask recentemente criado ou nulo, se não for possível criar a tarefa.
Devolver Valor
| HRESULT | Description |
|---|---|
| S_OK | O método foi devolvido com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
| HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
| HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo. |
| E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Não existe memória suficiente disponível para alocar o recurso pedido. |
Observações
O CLR cria uma nova tarefa automaticamente após a inicialização, quando o código de utilizador cria um thread através de tipos no System.Threading espaço de nomes ou quando o tamanho do conjunto de threads é aumentado. Também cria tarefas quando o código não gerido faz uma chamada para uma função gerida.
CreateTask permite ao anfitrião fazer um pedido explícito para que o CLR crie uma nova tarefa. Por exemplo, o anfitrião pode invocar este método para pré-configurar estruturas de dados.
Importante
A nova tarefa é devolvida num estado suspenso e permanece suspensa até que o anfitrião chame explicitamente IHostTask::Start.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0
