Método IHostGCManager::ThreadIsBlockingForSuspension

Artigo
08/25/2010

Notifica o host que o thread a partir da qual foi feita a telefonar do método está prestes a bloquear para um lixo coleção.

HRESULT ThreadIsBlockingForSuspension ();

Valor de retorno

HRESULT	Descrição
S_OK	ThreadIsBlockingForSuspension retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common linguagem tempo de execuçã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

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

Observação importante:
O host pode reagendar as tarefas somente após uma telefonar para ThreadIsBlockingForSuspension. Após o tempo de execução chama SuspensionStarting, o host não deve reagendar uma tarefa.