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, will immediately invalidate all debugging interfaces that are related to generating a stack trace for the thread. These interfaces include ICorDebugChain, ICorDebugILFrame, ICorDebugInternalFrame, and ICorDebugNativeFrame.

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 callback that has not yet been continued.

• While code execution is stopped because of an ICorDebugManagedCallback::EditAndContinueRemap 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

See Also

Concepts

ICorDebugILFrame2 Interface