Partager via


ICLROnEventManager::RegisterActionOnEvent, méthode

Inscrit un pointeur de rappel pour l’événement spécifié.

Syntaxe

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

Paramètres

event
[in] Une des valeurs EClrEvent, indiquant l’événement pour lequel inscrire le pointeur de rappel décrit par pAction.

pAction
[in] Pointeur vers un objet IActionOnCLREvent appelé lorsque l’événement inscrit se déclenche.

Valeur de retour

HRESULT Description
S_OK RegisterActionOnEvent retourné.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant n’est pas propriétaire du verrou.
HOST_E_ABANDONED Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

L’hôte peut inscrire des rappels pour les deux types d’événements décrits par EClrEvent. L’hôte obtient l’interface ICLROnEventManager en appelant la méthode ICLRControl::GetCLRManager.

Notes

Les événements inscrits par RegisterActionOnEvent peuvent être déclenchés plusieurs fois et à partir de différents threads pour signaler un déchargement ou la désactivation du CLR.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi