ICorDebugILFrame::SetIP Method
Sets the instruction pointer to the specified offset location in the Microsoft intermediate language (MSIL) code.
HRESULT SetIP (
[in] ULONG32 nOffset
);
Parameters
- nOffset
The offset location in the MSIL code.
Remarks
Calls to SetIP immediately invalidate all frames and chains for the current thread. If the debugger needs frame information after a call to SetIP, it must perform a new stack trace.
ICorDebug Interface will attempt to keep the stack frame in a valid state. However, even if the frame is in a valid state, there still may be problems such as uninitialized local variables. The caller is responsible for ensuring the coherency of the running program.
On 64-bit platforms, the instruction pointer cannot be moved out of a catch or finally block. If SetIP is called to make such a move on a 64-bit platform, it will return an HRESULT indicating failure.
Requirements
Platforms: Windows 2000, Windows XP, Windows Server 2003 family
Header: CorDebug.idl
Library: CorGuids.lib
.NET Framework Version: 2.0, 1.1, 1.0