IActionOnCLREvent::OnEvent, méthode

Article
05/09/2023

Effectue des rappels sur les événements inscrits à l’aide d’un appel à la méthode ICLROnEventManager::RegisterActionOnEvent.

Syntaxe

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 sur event.

Valeur de retour

HRESULT	Description
S_OK	`OnEvent` 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é pendant qu’un thread ou une fibre bloqué l’attendait.
E_FAIL	Une défaillance catastrophique inconnue s’est produite. Lorsqu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le 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 effectuer une action appropriée à l’aide de cet identificateur en tant que clé.

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

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

Partager via