Partager via


MDAInfo, structure

Fournit des détails sur l'événement Event_MDAFired, qui déclenche la création d'un Assistant Débogage managé (MDA, Managed Debugging Assistant).

typedef struct _MDAInfo {
    LPCWSTR  lpMDACaption;
    LPCWSTR  lpMDAMessage
} MDAInfo;

Membres

Membre

Description

lpMDACaption

Titre du MDA actuel. Le titre décrit le genre d'échec qui a déclenché l'événement Event_MDAFired.

lpMDAMessage

Message de sortie fourni par le MDA actuel.

Notes

Les Assistants Débogage managé sont des outils de débogage qui fonctionnent avec le Common Language Runtime (CLR) pour effectuer des tâches telles que l'identification de conditions non valides dans le moteur d'exécution du runtime ou le dump d'informations supplémentaires sur l'état du moteur. Les MDA génèrent des messages XML sur des événements qui sont difficiles à intercepter. Ils sont particulièrement utiles pour déboguer des transitions entre code managé et code non managé.

Le runtime effectue les étapes suivantes lorsqu'un événement qui déclenche la création d'un MDA se produit :

  • Si l'hôte n'a pas enregistré une instance IActionOnCLREvent en appelant ICLROnEventManager::RegisterActionOnEvent pour être notifié d'un événement Event_MDAFired, le runtime poursuit alors son comportement par défaut, non hébergé.

  • Si l'hôte a enregistré un gestionnaire pour cet événement, le runtime vérifie alors si un débogueur est attaché au processus. Si tel est le cas, le runtime s'arrête dans le débogueur. Lorsque le débogueur continue, il appelle l'hôte. Si aucun débogueur n'est joint, le runtime appelle IActionOnCLREvent::OnEvent et passe un pointeur vers une instance MDAInfo comme paramètre data.

L'hôte peut choisir d'activer les MDA et d'être notifié lorsqu'un MDA est activé. Cela donne à l'hôte la possibilité de substituer le comportement par défaut et d'abandonner le thread managé qui a déclenché l'événement pour l'empêcher d'endommager l'état du processus. Pour plus d'informations sur l'utilisation des Assistants Débogage managé, consultez Diagnostic d'erreurs avec les Assistants de débogage managés.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.idl

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

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Concepts

Diagnostic d'erreurs avec les Assistants de débogage managés

Autres ressources

Structures d'hébergement