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