Edit

Share via

IDebugThread2::SetNextStatement

  • Article

Sets the current instruction pointer to the given code context.

Syntax

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