IDebugProgram2::Step

  • Article

Performs a step.

Note

This method is deprecated. Use the IDebugProcess3::Step method instead.

HRESULT Step( 
   IDebugThread2*  pThread,
   STEPKIND        sk,
   STEPUNIT        step
);

int Step( 
   IDebugThread2  pThread,
   enum_STEPKIND  sk,
   enum_STEPUNIT  step
);

Parameters

  • pThread
    [in] An IDebugThread2 object that represents the thread being stepped.

  • sk
    [in] A value from the STEPKIND enumeration that specifies the kind of step.

  • step
    [in] A value from the STEPUNIT enumeration that specifies the unit of step (for example, by statement or instruction).

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

In case there is any thread synchronization or communication between threads, other threads in the program should run when a particular thread is stepping.

Warning

Do not send a stopping event or an immediate (synchronous) event to IDebugEventCallback2::Event while handling this call; otherwise the debugger may hang.

See Also

Reference

IDebugProgram2

IDebugEngineProgram2

IDebugEventCallback2::Event