ICorDebugILFrame2::RemapFunction Method
Remaps an edited function by specifying the new Microsoft intermediate language (MSIL) offset
HRESULT RemapFunction (
[in] ULONG32 newILOffset
);
Parameters
newILOffset
[in] The stack frame's new MSIL offset at which the instruction pointer should be placed. This value must be a sequence point.It is the caller’s responsibility to ensure the validity of this value. For example, the MSIL offset is not valid if it is outside the bounds of the function.
Remarks
When a frame’s function has been edited, the debugger can call the RemapFunction method to swap in the latest version of the frame's function so it can be executed. The code execution will begin at the given MSIL offset.
Note
Calling RemapFunction, like calling ICorDebugILFrame::SetIP Method, will immediately invalidate all debugging interfaces that are related to generating a stack trace for the thread. These interfaces include ICorDebugChain Interface, ICorDebugILFrame Interface, ICorDebugInternalFrame Interface, and ICorDebugNativeFrame Interface.
The RemapFunction method can be called only in the context of the current frame, and only in one of the following cases:
After receipt of a ICorDebugManagedCallback2::FunctionRemapOpportunity Method callback that has not yet been continued.
While code execution is stopped because of an ICorDebugManagedCallback::EditAndContinueRemap Method event for this frame.
Requirements
Platforms: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorDebug.idl
Library: CorGuids.lib
.NET Framework Version: 2.0