Partilhar via

Método IActionOnCLREvent::OnEvent

Efetua chamadas de retorno em eventos que foram registados através de uma chamada para o método ICLROnEventManager::RegisterActionOnEvent .

Sintaxe

HRESULT OnEvent (  
    [in] EClrEvent event,  
    [in] PVOID     data  
);

Parâmetros

event
[in] Um dos valores EClrEvent , que indica o tipo de evento.

data
[in] Um ponteiro para um objeto que contém detalhes sobre event.

Devolver Valor

HRESULT Description
S_OK OnEvent devolvido com êxito.
HOST_E_CLRNOTAVAILABLE O runtime de linguagem comum (CLR) não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Se um método devolver E_FAIL, o CLR deixará de ser utilizável no processo. As chamadas subsequentes para qualquer método de alojamento devolvem HOST_E_CLRNOTAVAILABLE.

Observações

O data parâmetro é um ponteiro para um objeto de tipo não especificado. Se o event parâmetro for Event_DomainUnload, data é o identificador numérico do AppDomain que foi descarregado. O anfitrião pode tomar as medidas adequadas com este identificador como chave.

Se event for Event_MDAFired, data é um ponteiro para uma instância MDAInfo que contém a saída da mensagem de um Assistente de Depuração Gerida (MDA). Os MDAs são uma funcionalidade do CLR que ajuda os programadores com a depuração, ao gerar mensagens XML sobre eventos que de outra forma são difíceis de capturar. Estas mensagens podem ser especialmente úteis na depuração de transições entre código gerido e não gerido. Para obter mais informações, veja Diagnosticar Erros com Assistentes de Depuração Gerida.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

.NET Framework Versões: Disponível desde 2.0

Ver também

  • Last updated on