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