Método de IActionOnCLREvent::OnEvent

Artigo
08/08/2011

Executa os retornos de chamada em eventos que foram registrados por meio de uma chamada para o ICLROnEventManager::RegisterActionOnEvent método.

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

Parâmetros

event
[in] Dentre as EClrEvent valores, que indica o tipo de evento.
data
[in] Um ponteiro para um objeto que contém detalhes sobre event.

Valor de retorno

HRESULT	Descrição
S_OK	OnEventretornado 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. Se um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes a qualquer método de hospedagem retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O data parâmetro é um ponteiro para um objeto do tipo não especificado. Se o event parâmetro é Event_DomainUnload, data o identificador numérico para o AppDomain que foi descarregado. O host pode agir apropriado usando esse identificador como uma chave.

Se event é Event_MDAFired, data é um ponteiro para um MDAInfo instância que contém a mensagem de saída de um gerenciado depuração MDA (Assistente). Os MDAs são um recurso do CLR que ajudam os desenvolvedores com a depuração, gerando mensagens XML sobre eventos que são difíceis de trapping. Tais mensagens podem ser especialmente útil em transições entre código gerenciado e de depuração. Para obter mais informações, consulte Diagnosticar erros com assistentes de depuração gerenciada.