ICorDebug-interface
Biedt methoden waarmee ontwikkelaars fouten kunnen opsporen in toepassingen in de CLR-omgeving (Common Language Runtime).
Notitie
Foutopsporing in gemengde modus (beheerde en systeemeigen code) wordt niet ondersteund op niet-x86-platforms (zoals IA64 en AMD64).
Methoden
| Methode | Beschrijving |
|---|---|
| Methode CanLaunchOrAttach | Bepaalt of het starten van een nieuw proces of koppelen aan het opgegeven proces mogelijk is binnen de context van de huidige machine- en runtimeconfiguratie. |
| Methode CreateProcess | Start een proces en de primaire thread onder het beheer van het foutopsporingsprogramma. |
| Methode DebugActiveProcess | Koppelt het foutopsporingsprogramma aan een bestaand proces. |
| Methode EnumerateProcesses | Hiermee haalt u een enumerator op voor de processen die worden opgespoord. |
| Methode GetProcess | Retourneert het object 'ICorDebugProcess' met de opgegeven proces-id. |
| Methode initialiseren | Initialiseert het ICorDebug object. |
| Methode SetManagedHandler | Hiermee geeft u het gebeurtenishandlerobject voor beheerde gebeurtenissen. |
| Methode SetUnmanagedHandler | Hiermee geeft u het gebeurtenishandlerobject voor niet-beheerde gebeurtenissen. |
| Methode beëindigen | Hiermee wordt het ICorDebug object beëindigd. |
Opmerkingen
ICorDebug vertegenwoordigt een gebeurtenisverwerkingslus voor een foutopsporingsprogrammaproces. Het foutopsporingsprogramma moet wachten op de callback ICorDebugManagedCallback::ExitProcess van alle processen die worden opgespoord voordat deze interface wordt vrijgegeven.
Het ICorDebug object is het eerste object voor het beheren van alle verdere beheerde foutopsporing. In de .NET Framework versies 1.0 en 1.1 was dit object een CoClass object dat is gemaakt op basis van COM. In .NET Framework versie 2.0 is dit object geen object meerCoClass. Deze moet worden gemaakt door de functie CreateDebuggingInterfaceFromVersion , die versiebewuster is. Met deze nieuwe functie voor het maken kunnen clients een specifieke implementatie van ICorDebugophalen, die ook een specifieke versie van de foutopsporings-API nabootst.
Notitie
Deze interface biedt geen ondersteuning voor het extern aangeroepen worden, zowel op meerdere machines als op meerdere processen.
Vereisten
Platforms: Zie Systeemvereisten.
Header: CorDebug.idl, CorDebug.h
Bibliotheek: CorGuids.lib
.NET Framework versies: beschikbaar sinds 1.0
