Metodo ICLROnEventManager::RegisterActionOnEvent

Articolo
08/11/2011

Registra un puntatore di callback per l'evento specificato.

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

Parametri

event
[in] Uno dei valori diEClrEvent che indica l'evento per il quale deve essere registrato 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	Oggetto di descrizione
S_OK	RegisterActionOnEvent 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, CLR non sarà più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

L'host può registrare 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 registrati da RegisterActionOnEvent possono essere generati più volte e da thread differenti per segnalare uno scaricamento o la disattivazione di CLR.