Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Sets the instruction pointer to the specified offset location in the common intermediate language (CIL) code.
Syntax
HRESULT SetIP (
[in] ULONG32 nOffset
);
Parameters
nOffset
The offset location in the CIL 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, 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: See System Requirements.
Header: CorDebug.idl, CorDebug.h
Library: CorGuids.lib
.NET Framework Versions: Available since 1.0
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
