Método de ICLRTaskManager::CreateTask

Artigo
08/08/2011

Solicita explicitamente que o common language runtime (CLR) cria uma nova tarefa.

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

Parâmetros

pTask
[out] Um ponteiro para o endereço de um recém-criado ICLRTask, ou null, se a tarefa não pôde ser criada.

Valor de retorno

HRESULT	Descrição
S_OK	O método retornou com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não há memória suficiente está disponível para alocar o recurso solicitado.

Comentários

O CLR cria uma nova tarefa automaticamente na inicialização, quando o código de usuário cria um segmento por meio de tipos na System.Threading namespace, ou quando o tamanho do pool de segmentos é aumentado. Ele também cria tarefas quando código não gerenciado faz uma chamada para uma função gerenciada.

CreateTaskpermite que o host a fazer uma solicitação explícita que o CLR cria uma nova tarefa. Por exemplo, o host pode chamar esse método para preinitialize as estruturas de dados.