Compartilhar via


Interface ICLRTask2

Fornece toda a funcionalidade da interface ICLRTask; além disso, fornece métodos que permitem que as anulações de thread sejam atrasadas na thread atual.

Métodos

Método Descrição
Método BeginPreventAsyncAbort Atrasa novas solicitações de aborto de thread na thread atual.
Método EndPreventAsyncAbort Permite que solicitações de anulação de encadeamento novas ou pendentes resultem em anulações de thread na thread atual.

Comentários

A ICLRTask2interface herda a ICLRTaskinterface e adiciona métodos que permitem ao host atrasar as anulações de thread, para proteger uma região de código que não deve falhar. A chamada BeginPreventAsyncAbortincrementa o contador de interrupção de thread de atraso para o thread atual e a chamadaEndPreventAsyncAbort o diminui. Chamadas para BeginPreventAsyncAbort e EndPreventAsyncAbort podem ser aninhadas. Enquanto o contador for maior que zero, as anulações de thread para a thread atual são atrasadas.

Se as chamadas para BeginPreventAsyncAbort e EndPreventAsyncAbort não estiverem pareadas, é possível chegar a um estado no qual as anulações de thread não podem ser entregues a thread atual.

O atraso não é honrado por uma thread que se anula.

A funcionalidade exposta por esse recurso é usada internamente pela máquina virtual (VM). O uso indevido desses métodos pode causar um comportamento não especificado na VM. Por exemplo, chamar EndPreventAsyncAbort sem primeiro chamar BeginPreventAsyncAbort pode definir o contador como zero quando a VM tiver incrementado anteriormente. Da mesma forma, o contador interno não é verificado quanto ao estouro. Se exceder seu limite integral porque é incrementado pelo host e pela VM, o comportamento resultante não será especificado.

Para obter informações sobre membros herdados de ICLRTask e sobre os outros usos dessa interface, consulte a interface ICLRTask.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 4

Confira também