IDebugSystemObjects::SetCurrentThreadId method

The SetCurrentThreadId method makes the specified thread the current thread.

Syntax


HRESULT SetCurrentThreadId(
  [in]  ULONG Id
);

Parameters

Id [in]

Specifies the engine thread ID of the thread that is to become the current thread.

Return value

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

Return codeDescription
S_OK

The method was successful.

E_NOINTERFACE

No thread with the specified ID was found.

 

Remarks

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

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

Note   In kernel-mode debugging, the current thread is a virtual thread, it is not a system thread. This method cannot be used to change between system threads in kernel-mode debugging. However, the implicit thread may be changed by using SetImplicitThreadDataOffset.

For more information about threads, see Threads and Processes. For details on monitoring events, see Monitoring Events.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft