ICorDebug-Schnittstelle

Stellt Methoden bereit, mit denen Entwickler Anwendungen in der ClR-Umgebung (Common Language Runtime) debuggen können.

Hinweis

Das Debuggen im gemischten Modus (verwalteter und systemeigener Code) wird auf Nicht-x86-Plattformen (z. B. IA64 und AMD64) nicht unterstützt.

Methodik

Methode	Description
CanLaunchOrAttach-Methode	Bestimmt, ob das Starten eines neuen Prozesses oder das Anfügen an den angegebenen Prozess im Kontext des aktuellen Computers und der Laufzeitkonfiguration möglich ist.
CreateProcess-Methode	Startet einen Prozess und seinen primären Thread unter der Kontrolle des Debuggers.
DebugActiveProcess-Methode	Fügt den Debugger an einen vorhandenen Prozess an.
EnumerateProcesses-Methode	Ruft einen Enumerator für die Prozesse ab, die gedebuggt werden.
GetProcess-Methode	Gibt das Objekt "ICorDebugProcess" mit der angegebenen Prozess-ID zurück.
Initialize-Methode	Initialisiert das ICorDebug Objekt.
SetManagedHandler-Methode	Gibt das Ereignishandlerobjekt für verwaltete Ereignisse an.
SetUnmanagedHandler-Methode	Gibt das Ereignishandlerobjekt für nicht verwaltete Ereignisse an.
Terminate-Methode	Beendet das ICorDebug Objekt.

Bemerkungen

ICorDebug stellt eine Ereignisverarbeitungsschleife für einen Debuggerprozess dar. Der Debugger muss auf den ICorDebugManagedCallback::ExitProcess-Rückruf aller Prozesse warten, die gedebuggt werden, bevor diese Schnittstelle freigegeben wird.

Das ICorDebug Objekt muss von der Funktion CreateDebuggingInterfaceFromVersion erstellt werden, sodass Clients eine bestimmte Implementierung dieser ICorDebug Api emuliert.

Hinweis

Diese Schnittstelle unterstützt nicht die Remote-Aufrufe, entweder computerübergreifend oder prozessübergreifend.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 1.0