Método ICLRTask::YieldTask

Artigo
08/25/2010

Solicita que o Common linguagem tempo de execução (CLR) coloca lado a tarefa que o corrente ICLRTask representa da instância e verifique o time do processador disponível para outras tarefas.

HRESULT YieldTask ();

Valor de retorno

HRESULT	Descrição
S_OK	YieldTask retornado 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.

Comentários

Um host chama YieldTask para solicitar os recursos de processador para outros processos ou tarefas. Esse método destina-se principalmente a permitir código longa desistir de time de CPU. O time de execução tenta colocar a tarefa que o corrente ICLRTask instância representa em um estado onde ele pode gerar o time de processamento, mas não garante de sucesso.