IActionOnCLREvent::OnEvent, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Exécute des rappels sur les événements qui ont été enregistrés à l'aide d'un appel à la méthode ICLROnEventManager::RegisterActionOnEvent.

HRESULT OnEvent (
    [in] EClrEvent event,
    [in] PVOID     data
);

Paramètres

event
[in] Une des valeurs EClrEvent, qui indique le type d'événement.
data
[in] Pointeur vers un objet qui contient des détails à propos de event.

Valeur de retour

HRESULT	Description
S_OK	OnEvent a été retourné correctement.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Si une méthode retourne E_FAIL, le CLR n'est plus utilisable au sein du processus. Les appels suivants à toute méthode d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

Le paramètre data est un pointeur vers un objet de type non spécifié. Si le paramètre event est Event_DomainUnload, data est l'identificateur numérique du AppDomain qui a été déchargé. L'hôte peut prendre la mesure appropriée en utilisant cet identificateur comme une clé.

Si event est Event_MDAFired, data est un pointeur vers une instance MDAInfo contenant la sortie de message d'un Assistant Débogage managé (MDA). L'Assistant Débogage managé est une fonctionnalité du CLR qui aide les développeurs lors du débogage, en générant des messages XML à propos des événements qui sont généralement difficiles à intercepter. Ces messages peuvent être particulièrement utiles pour déboguer des transitions entre code managé et code non managé. Pour plus d'informations, consultez Diagnostic d'erreurs avec les Assistants de débogage managés.