ICorDebug-Schnittstelle
Stellt Methoden bereit, mit denen Entwickler Anwendungen in der CLR-Umgebung (Common Language Runtime) debuggen können.
Hinweis
Debuggen im gemischten Modus (verwalteter und nativer Code) wird auf Nicht-x86-Plattformen (z. B. IA64 und AMD64) nicht unterstützt.
Methoden
| Methode | BESCHREIBUNG |
|---|---|
| CanLaunchOrAttach-Methode | Bestimmt, ob das Starten eines neuen Prozesses oder das Anfügen an den angegebenen Prozess im Kontext der aktuellen Computer- und Laufzeitkonfiguration möglich ist. |
| CreateProcess-Methode | Startet einen Prozess und den zugehörigen 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 „ICorDebugProcess“-Objekt 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 warten, bis der ICorDebugManagedCallback::ExitProcess-Rückruf von allen Prozessen erfolgt ist, die gedebuggt werden, bevor diese Schnittstelle freigegeben wird.
Das ICorDebug-Objekt ist das anfängliche Objekt, um das gesamte weitere verwaltete Debuggen zu steuern. In den .NET Framework Version 1.0 und 1.1 war dieses Objekt ein CoClass-Objekt, das aus COM erstellt wurde. In .NET Framework Version 2.0 ist dieses Objekt kein CoClass-Objekt mehr. Es muss von der CreateDebuggingInterfaceFromVersion-Funktion erstellt werden, die versionsabhängiger ist. Mit dieser neuen Erstellungsfunktion können Clients eine bestimmte Implementierung von ICorDebug abrufen, die auch eine bestimmte Version der Debug-API emuliert.
Hinweis
Diese Schnittstelle kann weder computerübergreifend noch prozessübergreifend remote aufgerufen werden.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorDebug.idl, CorDebug.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: Seit Version 1.0 verfügbar
