Condividi tramite

Metodo ICLROnEventManager::RegisterActionOnEvent

  • Articolo

Registra un puntatore di callback per l'evento specificato.

Sintassi

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

Parametri

event
[in] Uno dei valori EClrEvent , che indica l'evento per il quale registrare il puntatore di callback descritto da pAction.

pAction
[in] Puntatore a un oggetto IActionOnCLREvent che viene chiamato quando viene generato l'evento registrato.

Valore restituito

HRESULT Descrizione
S_OK RegisterActionOnEvent 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 durante l'attesa di un thread o di una fibra bloccata.
E_FAIL Si è verificato un errore irreversibile sconosciuto. Dopo che un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Commenti

L'host può registrare i callback per uno o entrambi i tipi di evento descritti da EClrEvent. L'host ottiene l'interfaccia ICLROnEventManager chiamando il metodo ICLRControl::GetCLRManager .

Nota

Gli eventi che RegisterActionOnEvent registrano possono essere attivati più volte e da thread diversi per segnalare un scaricamento o la disabilitazione di CLR.

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