Condividi tramite

Metodo IActionOnCLREvent::OnEvent

  • Articolo

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

Vedi anche