Método ICLRTaskManager::CreateTask

Artigo
08/25/2010

Solicita explicitamente que o common linguagem tempo de execução (CLR) criar 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 nulo, 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 está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem 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 durante a inicialização, quando o código de usuário cria um segmento usando tipos no System.Threading espaço para nome, ou quando o dimensionar do pool de segmentos é aumentado. Ele também cria tarefas quando o código não gerenciado faz um telefonar para uma função gerenciada.

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