Share via


ICorDebugNativeFrame::SetIP Method

Sets the instruction pointer to the specified offset location in native code.

HRESULT SetIP (
    [in] ULONG32 nOffset
);

Parameters

  • nOffset
    [in] The offset location in the native 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 will attempt to keep the stack frame in a valid state. However, even if the frame is in a valid state, as far as the runtime is concerned, there still may be problems, such as uninitialized local variables, and so on. The caller is responsible for insuring 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

See Also

Concepts

ICorDebugNativeFrame Interface