IDebugControl2::SetExecutionStatus method (dbgeng.h)

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)

See also

GetExecutionStatus

IDebugControl

IDebugControl2

IDebugControl3