Metodo IActionOnCLREvent::OnEvent

Articolo
08/11/2011

Esegue callback su eventi registrati tramite una chiamata al metodo ICLROnEventManager::RegisterActionOnEvent.

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

Parametri

event
[in] Uno dei valori di EClrEvent, che indica il tipo di evento.
data
[in] Puntatore a un oggetto contenente i dettagli relativi all'evento indicato in event.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	OnEvent ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, Common Language Runtime non sarà più utilizzabile all'interno del processo. Le chiamate successive a un metodo di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

Il parametro data è un puntatore a un oggetto di tipo non specificato. Se il parametro event è Event_DomainUnload, data sarà l'identificatore dell'oggetto AppDomain scaricato. L'host può eseguire l'azione appropriata utilizzando questo identificatore come chiave.

Se event è Event_MDAFired, data sarà un puntatore a un'istanza di MDAInfo contenente l'output di messaggio da un assistente al debug gestito (MDA, Managed Debugging Assistant). Gli assistenti al debug gestito sono una funzionalità di CLR che, grazie alla generazione di messaggi XML su eventi altrimenti difficili da rilevare, semplifica le operazioni di debug per gli sviluppatori. Questi messaggi sono particolarmente utili per eseguire il debug delle operazioni di transizione da codice gestito a codice non gestito. Per ulteriori informazioni, vedere Diagnostica degli errori tramite gli assistenti al debug gestito.