Método de ICLROnEventManager::RegisterActionOnEvent

Registra um ponteiro de retorno de chamada para o evento especificado.

HRESULT RegisterActionOnEvent (
    [in] EClrEvent event,
    [in] IActionOnCLREvent *pAction
);

Parâmetros

event
[in] Dentre as EClrEvent valores, indicando que o evento para o qual deseja registrar o ponteiro de retorno de chamada descrito por pAction.
pAction
[in] Um ponteiro para um IActionOnCLREvent objeto é chamado quando o evento registrado for acionado.

Valor de retorno

HRESULT	Descrição
S_OK	RegisterActionOnEventretornado 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. Depois de um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O host pode registrar retornos de chamada para um ou ambos os dois tipos de evento descritos por EClrEvent. O host obtém o ICLROnEventManager interface chamando o ICLRControl::GetCLRManager método.

Observação

Os eventos que RegisterActionOnEvent pode ser acionada registra mais de uma vez e de diversos threads para sinalizar um descarregamento ou a desativação do CLR.