ICorDebugILFrame2::RemapFunction-Methode
Aktualisiert: November 2007
Ordnet eine bearbeitete Funktion durch Angabe des neuen Microsoft Intermediate Language (MSIL)-Offsets neu zu.
HRESULT RemapFunction (
[in] ULONG32 newILOffset
);
Parameter
newILOffset
[in] Der neue MSIL-Offset des Stapelrahmens, an dem der Anweisungszeiger platziert werden sollte. Dieser Wert muss ein Sequenzpunkt sein.Der Aufrufer ist dafür verantwortlich, die Gültigkeit dieses Werts sicherzustellen. Beispielsweise ist der MSIL-Offset nicht gültig, wenn er außerhalb der Grenzen der Funktion liegt.
Hinweise
Wenn die Funktion eines Frames bearbeitet wurde, kann der Debugger die RemapFunction-Methode aufrufen, damit die neueste Version der Funktion des Frames ausgeführt wird. Die Codeausführung beginnt am angegebenen MSIL-Offset.
Tipp
Durch den Aufruf von RemapFunction verlieren ebenso wie durch den Aufruf von ICorDebugILFrame::SetIP alle Debugschnittstellen, die in Verbindung mit der Generierung einer Stapelüberwachung für den Thread stehen, unverzüglich ihre Gültigkeit. Zu diesen Schnittstellen gehören ICorDebugChain, ICorDebugILFrame, ICorDebugInternalFrame und ICorDebugNativeFrame.
Die RemapFunction-Methode kann nur im Kontext des aktuellen Frames und nur in einem der folgenden Fälle aufgerufen werden:
Nach dem Empfang eines ICorDebugManagedCallback2::FunctionRemapOpportunity-Rückrufs, der noch nicht fortgesetzt wurde.
Während einer Unterbrechung der Codeausführung aufgrund eines ICorDebugManagedCallback::EditAndContinueRemap-Ereignisses für diesen Frame.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: CorDebug.idl
Bibliothek: CorGuids.lib
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0