Edit

Share via

IDebugSystemObjects::SetCurrentThreadId method (dbgeng.h)

  • Article

The SetCurrentThreadId method makes the specified thread the current thread.

Syntax

HRESULT SetCurrentThreadId(
  [in] ULONG Id
);

Parameters

[in] Id

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 code Description
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

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