Share via

IDebugThread2::SetNextStatement

  • Article

Sets the current instruction pointer to the given code context.

HRESULT SetNextStatement ( 
   IDebugStackFrame2*  pStackFrame,
   IDebugCodeContext2* pCodeContext
);

int SetNextStatement ( 
   IDebugStackFrame2  pStackFrame,
   IDebugCodeContext2 pCodeContext
);

Parameters

  • pStackFrame
    Reserved for future use; set to a null value.

  • pCodeContext
    [in] An IDebugCodeContext2 object that describes the code location about to be executed and its context.

Return Value

If successful, returns S_OK; otherwise, returns an error code. The following table shows other possible values.

Value

Description

E_CANNOT_SET_NEXT_STATEMENT_ON_NONLEAF_FRAME

The next statement cannot be in a stack frame deeper on the frame stack.

E_CANNOT_SETIP_TO_DIFFERENT_FUNCTION

The next statement is not associated with any frame in the stack.

E_CANNOT_SET_NEXT_STATEMENT_ON_EXCEPTION

Some debug engines cannot set the next statement after an exception.

Remarks

The instruction pointer indicates the next instruction or statement to execute. This method is used to retry a line of source code or to force execution to continue in another function, for example.

See Also

Reference

IDebugThread2

IDebugStackFrame2

IDebugCodeContext2