ICorDebugDataTarget-Schnittstelle

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

Methodik

Methode	Description
GetPlatform-Methode	Stellt Informationen zur Plattform bereit, einschließlich Prozessorarchitektur und Betriebssystem, auf der der Zielprozess ausgeführt wird.
ReadVirtual-Methode	Ruft einen Block des zusammenhängenden Speichers ab der angegebenen Adresse ab und gibt ihn im angegebenen Puffer zurück.
GetThreadContext-Methode	Fordert den aktuellen Threadkontext für den angegebenen Thread an.

Bemerkungen

ICorDebugDataTarget und ihre Methoden weisen die folgenden Merkmale auf:

• Die Debugdienste rufen Methoden auf dieser Schnittstelle auf, um auf Speicher und andere Daten im Zielprozess zuzugreifen.
• Der Debuggerclient muss diese Schnittstelle entsprechend dem jeweiligen Ziel implementieren (z. B. einen Liveprozess oder ein Speicherabbild).
• Die ICorDebugDataTarget Methoden können nur innerhalb von Methoden aufgerufen werden, die in anderen ICorDebug* Schnittstellen implementiert sind. Dadurch wird sichergestellt, dass der Debuggerclient die Kontrolle darüber hat, für welchen Thread er aufgerufen wird, und wann.
• Die ICorDebugDataTarget Implementierung muss immer up-to-datumsinformationen zum Ziel zurückgeben.

Der Zielprozess sollte beendet und nicht auf irgendeine Weise geändert werden, während ICorDebug* Schnittstellen (und daher 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 Ersatzinstanz ICorDebugProcess bereitzustellen.

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 4.0