IDebugProcess3::Step

  • Article

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Causes the process to step one instruction or statement.

Note

This method should be used instead of Step.

Syntax

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

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

Parameters

pThread
[in] An IDebugThread2 object representing the thread being stepped.

sk
[in] One of the STEPKIND values.

step
[in] One of the STEPUNIT values.

Return Value

If successful, returns S_OK; otherwise returns error code.

Remarks

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

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

See also