SetCurrentSystemId

The SetCurrentSystemId method makes the specified target the current target.

HRESULT
  IDebugSystemObjects3::SetCurrentSystemId(
    IN ULONG  Id
    );

Parameters

Id

Specifies the engine target ID for the target that is to become the current target.

Return Value

S_OK

The method was successful.

E_NOINTERFACE

No process with the given ID was found.

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

Interface Version

SetCurrentSystemId is available in IDebugSystemObjects3 and later versions.

Comments

This method also sets the current thread and current process, and may change the current computer.

If the current target is changed, the callback IDebugEventCallbacks::ChangeEngineState will be called with the DEBUG_CES_CURRENT_THREAD bit set.

Requirements

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

See Also

Debugging Session and Execution Model, Monitoring Events