ICorDebug, interface

  • Article

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

Voir aussi