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
