ICorDebugILFrame::SetIP-Methode

Legt den Anweisungszeiger auf die angegebene Offsetposition im CIL-Code (Common Intermediate Language) fest.

Syntax

HRESULT SetIP (
    [in] ULONG32 nOffset
);

Die Parameter

nOffset Die Offsetposition im CIL-Code.

Bemerkungen

Aufrufe, um alle Frames und Ketten für den aktuellen Thread sofort ungültig zu SetIP machen. Wenn der Debugger Frameinformationen nach einem Aufruf SetIPbenötigt, muss er eine neue Stapelablaufverfolgung ausführen.

ICorDebug versucht, den Stapelrahmen in einem gültigen Zustand beizubehalten. Selbst wenn sich der Frame jedoch in einem gültigen Zustand befindet, können weiterhin Probleme auftreten, z. B. nicht initialisierte lokale Variablen. Der Aufrufer ist dafür verantwortlich, die Kohärenz des laufenden Programms sicherzustellen.

Auf 64-Bit-Plattformen kann der Anweisungszeiger nicht aus einem catch Oder finally Block verschoben werden. Wenn SetIP eine solche Bewegung auf einer 64-Bit-Plattform aufgerufen wird, wird ein HRESULT zurückgegeben, das einen Fehler angibt.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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