Freigeben über

ICorDebugILFrame::SetIP-Methode

  • Artikel

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

Syntax

HRESULT SetIP (
    [in] ULONG32 nOffset
);

Parameter

nOffset Die Offsetposition im CIL-Code.

Hinweise

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

ICorDebug versucht, einen gültigen Zustand für den Stapelframe beizubehalten. Selbst wenn sich der Frame in einem gültigen Zustand befindet, kann es dennoch Probleme geben, z. B. nicht initialisierte lokale Variablen. Der Aufrufer ist für die Sicherstellung der Kohärenz des ausgeführten Programms verantwortlich.

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit Version 1.0 verfügbar.