Freigeben über

ICorDebugDataTarget-Schnittstelle

  • Artikel

Stellt eine Rückrufschnittstelle bereit, die Zugriff auf einen bestimmten Zielprozess bietet.

Methoden

Methode BESCHREIBUNG
GetPlatform-Methode Stellt Informationen zur Plattform bereit, einschließlich Prozessorarchitektur und Betriebssystem, auf denen der Zielprozess ausgeführt wird.
ReadVirtual-Methode Ruft einen Block mit zusammenhängendem Arbeitsspeicher ab der angegebenen Adresse ab und gibt ihn im bereitgestellten Puffer zurück.
GetThreadContext-Methode Ruft den aktuellen Threadkontext für den angegebenen Thread ab.

Bemerkungen

ICorDebugDataTarget und seine Methoden weisen die folgenden Merkmale auf:

  • Die Debugdienste rufen Methoden auf dieser Schnittstelle auf, um auf Arbeitsspeicher und andere Daten im Zielprozess zuzugreifen.

  • Der Debuggerclient muss diese Schnittstelle entsprechend dem jeweiligen Ziel (z. B. einem Liveprozess oder einem Speicherabbild) implementieren.

  • Die ICorDebugDataTarget-Methoden können nur innerhalb von Methoden aufgerufen werden, die in anderen ICorDebug*-Schnittstellen implementiert sind. Dadurch wird sichergestellt, dass der Debuggerclient steuern kann, für welchen Thread er wann aufgerufen wird.

  • Die ICorDebugDataTarget-Implementierung muss immer aktuelle Informationen über das Ziel zurückgeben.

Der Zielprozess sollte beendet und in keiner Weise geändert werden, während ICorDebug*-Schnittstellen (und damit ICorDebugDataTarget-Methoden) aufgerufen werden. Wenn das Ziel ein Liveprozess ist und sich sein Zustand ändert, muss die ICLRDebugging::OpenVirtualProcess-Methode erneut aufgerufen werden, um eine ICorDebugProcess-Ersatzinstanz bereitzustellen.

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 4 verfügbar

Siehe auch