Metodo IActionOnCLREvent::OnEvent
Esegue callback sugli eventi registrati tramite una chiamata al metodo ICLROnEventManager::RegisterActionOnEvent .
Sintassi
HRESULT OnEvent (
[in] EClrEvent event,
[in] PVOID data
);
Parametri
event
[in] Uno dei valori EClrEvent , che indica il tipo di evento.
data
[in] Puntatore a un oggetto che contiene dettagli su event
.
Valore restituito
HRESULT | Descrizione |
---|---|
S_OK | OnEvent restituito correttamente. |
HOST_E_CLRNOTAVAILABLE | Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata. |
HOST_E_TIMEOUT | Timeout della chiamata. |
HOST_E_NOT_OWNER | Il chiamante non possiede il blocco. |
HOST_E_ABANDONED | Un evento è stato annullato mentre un thread bloccato o una fibra era in attesa su di esso. |
E_FAIL | Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive a qualsiasi metodo di hosting restituiscono HOST_E_CLRNOTAVAILABLE. |
Commenti
Il data
parametro è un puntatore a un oggetto di tipo non specificato. Se il event
parametro è Event_DomainUnload
, data
è l'identificatore numerico per l'oggetto AppDomain scaricato. L'host può eseguire un'azione appropriata usando questo identificatore come chiave.
Se event
è Event_MDAFired
, data
è un puntatore a un'istanza MDAInfo che contiene l'output del messaggio da un Assistente debug gestito. Gli mdA sono una funzionalità di CLR che consente agli sviluppatori di eseguire il debug generando messaggi XML sugli eventi che altrimenti sono difficili da intercettare. Tali messaggi possono essere particolarmente utili per il debug delle transizioni tra codice gestito e non gestito. Per altre informazioni, vedere Diagnosi degli errori con Gli assistenti al debug gestito.
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: MSCorEE.h
Libreria: Incluso come risorsa in MSCorEE.dll
Versioni di .NET Framework: Disponibile dalla versione 2.0