ICLROnEventManager::RegisterActionOnEvent (Método)
Registra un puntero de devolución de llamada para el evento especificado.
Sintaxis
HRESULT RegisterActionOnEvent (
[in] EClrEvent event,
[in] IActionOnCLREvent *pAction
);
Parámetros
event
[in] Uno de los valores de EClrEvent, que indica el evento para el que se va a registrar el puntero de devolución de llamada que describe pAction
.
pAction
[in] Puntero a un objeto IActionOnCLREvent al que se llama cuando se activa el evento registrado.
Valor devuelto
HRESULT | Descripción |
---|---|
S_OK | RegisterActionOnEvent se devolvió correctamente. |
HOST_E_CLRNOTAVAILABLE | El Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado o procesar la llamada correctamente. |
HOST_E_TIMEOUT | Se agotó el tiempo de espera de la llamada. |
HOST_E_NOT_OWNER | El autor de la llamada no es el propietario del bloqueo. |
HOST_E_ABANDONED | Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando. |
E_FAIL | Si se devuelve este valor, significa que ocurrió un error grave desconocido. Una vez que un método devuelva el valor E_FAIL, CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE. |
Comentarios
El host puede registrar devoluciones de llamada para uno de los tipos de eventos que describe EClrEvent
o para ambos. El host obtiene la interfaz ICLROnEventManager
llamando al método ICLRControl::GetCLRManager.
Nota
Los eventos que RegisterActionOnEvent
registra se pueden activar más de una vez y desde diferentes subprocesos para indicar una descarga o la deshabilitación de CLR.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0