IDebugControl::GetExecutionStatus method (dbgeng.h)

Article
02/22/2024

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

Syntax

HRESULT GetExecutionStatus(
  [out] PULONG Status
);

Parameters

[out] 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

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

Return code	Description
S_OK	The method was successful.

Remarks

For more information, see Target Information.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dbgeng.h (include Dbgeng.h)