Debugging Tools for Windows

GetExecutionStatus

The GetExecutionStatus method returns information about the execution status of the debugger engine.

HRESULT
  IDebugControl::GetExecutionStatus(
    OUT PULONG  Status
    );

Parameters

Status

Receives the execution status. This will be set to one of the values in the following table. Note that the description of these values differs slightly from the description in DEBUG_STATUS_XXX.

Value	Description
DEBUG_STATUS_NO_DEBUGGEE	The engine is not attached to a target.
DEBUG_STATUS_STEP_OVER	The target is currently executing a single instruction. If that instruction is a subroutine call, the entire call will be executed.
DEBUG_STATUS_STEP_INTO	The target is currently executing a single instruction.
DEBUG_STATUS_STEP_BRANCH	The target is currently running until it encounters a branch instruction.
DEBUG_STATUS_GO	The target is currently running normally. It will continue normal execution until an event occurs.
DEBUG_STATUS_BREAK	The target is not running.

Return Value

S_OK: The method was successful.

This method may also return error values. See Return Values for more details.

Interface Version

GetExecutionStatus is available in all versions of IDebugControl.

Comments

For more information, see Target Information.

Requirements