Rediger

Del via

ICorDebugNativeFrame::SetIP Method

  • Artikkel

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

Syntax

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: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also