SetExecutionStatus

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

HRESULT
  IDebugControl::SetExecutionStatus(
    IN ULONG  Status
    );

Parameters

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

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.

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

Interface Version

SetExecutionStatus is available in all versions of IDebugControl.

Comments

For more information, see Target Information.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetExecutionStatus