ICorDebug, interface
Fournit des méthodes qui permettent aux développeurs de déboguer des applications dans l’environnement du Common Language Runtime (CLR).
Notes
Le débogage en mode mixte (code managé et natif) n’est pas pris en charge sur les plateformes non-x86 (telles que IA64 et AMD64).
Méthodes
| Méthode | Description |
|---|---|
| CanLaunchOrAttach, méthode | Détermine si le lancement d’un nouveau processus ou l’attachement au processus donné est possible dans le contexte de la configuration actuelle de l’ordinateur et du runtime. |
| CreateProcess, méthode | Lance un processus et son thread principal sous le contrôle du débogueur. |
| DebugActiveProcess, méthode | Attache le débogueur à un processus existant. |
| EnumerateProcesses, méthode | Obtient un énumérateur pour les processus en cours de débogage. |
| GetProcess, méthode | Retourne l’objet « ICorDebugProcess » avec l’ID de processus donné. |
| Initialize, méthode | Initialise l'objet ICorDebug. |
| SetManagedHandler, méthode | Spécifie l’objet gestionnaire d’événements pour les événements managés. |
| SetUnmanagedHandler, méthode | Spécifie l’objet gestionnaire d’événements pour les événements non managés. |
| Terminate, méthode | Met fin à l’objet ICorDebug. |
Notes
ICorDebug représente une boucle de traitement d’événements pour un processus de débogueur. Le débogueur doit attendre le rappel ICorDebugManagedCallback::ExitProcess de tous les processus en cours de débogage avant de publier cette interface.
L’objet ICorDebug est l’objet initial qui permet de contrôler tous les autres débogages managés. Dans les versions 1.0 et 1.1 du .NET Framework, cet objet était un objet CoClass créé à partir de COM. Dans le .NET Framework version 2.0, cet objet n’est plus un objet CoClass. Il doit être créé par la fonction CreateDebuggingInterfaceFromVersion, qui tient davantage compte de la version. Cette nouvelle fonction de création permet aux clients d’obtenir une implémentation spécifique de ICorDebug, qui émule également une version spécifique de l’API de débogage.
Notes
Cette interface ne prend pas en charge l'appel à distance, que ce soit entre ordinateurs ou entre processus.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : CorDebug.idl, CorDebug.h
Bibliothèque : CorGuids.lib
Versions de .NET Framework : Disponible à partir de la version 1.0
