Método de IHostGCManager::ThreadIsBlockingForSuspension

Artigo
08/08/2011

Notifica o host que o thread a partir do qual a chamada de método foi feita está prestes a bloquear a uma coleta de lixo.

HRESULT ThreadIsBlockingForSuspension ();

Valor de retorno

HRESULT	Descrição
S_OK	ThreadIsBlockingForSuspensionretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (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.

Comentários

O CLR geralmente chama o ThreadIsBlockForSuspension método de preparação para uma coleta de lixo, para dar o host de uma oportunidade para reagendar o segmento para tarefas não gerenciado.

Importante
O host pode reagendar as tarefas somente após uma chamada para ThreadIsBlockingForSuspension.Após as chamadas de tempo de execução SuspensionStarting, o host não deve reagendar a uma tarefa.