IDebugControl2::SetExecutionStatus method (dbgeng.h)

Article
02/22/2024

The SetExecutionStatus method requests that the debugger engine enter an executable state. Actual execution will not occur until the next time WaitForEvent is called.

Syntax

HRESULT SetExecutionStatus(
  [in] ULONG Status
);

Parameters

[in] Status

Specifies the mode for the engine to use when executing. Possible values are those values in the table in DEBUG_STATUS_XXX whose precedence lies between DEBUG_STATUS_GO and DEBUG_STATUS_STEP_INTO.

Return value

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

Return code	Description
S_OK	The method was successful.
E_UNEXPECTED	Something prevented the execution of this method. Possible causes include: there is no current target, there is an outstanding request for input, or execution is not supported in the current target.
E_ACCESSDENIED	The target is already executing.
E_NOINTERFACE	No target can generate any more events.

Remarks

For more information, see Target Information.

Requirements

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