nf-dbgeng-idebugsystemobjects-setcurrentthreadid.md

UID	title	description	old-location	tech.root	ms.date	keywords	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	f1_keywords	topic_type	api_type	api_location	api_name
NF:dbgeng.IDebugSystemObjects.SetCurrentThreadId	IDebugSystemObjects::SetCurrentThreadId (dbgeng.h)	The (IDebugSystemObjects) SetCurrentThreadId method sets the current thread by specifying an engine thread ID.	debugger\setcurrentthreadid.htm	debugger	05/03/2018	IDebugSystemObjects::SetCurrentThreadId	IDebugSystemObjects interface [Windows Debugging],SetCurrentThreadId method, IDebugSystemObjects.SetCurrentThreadId, IDebugSystemObjects2 interface [Windows Debugging],SetCurrentThreadId method, IDebugSystemObjects2::SetCurrentThreadId, IDebugSystemObjects3 interface [Windows Debugging],SetCurrentThreadId method, IDebugSystemObjects3::SetCurrentThreadId, IDebugSystemObjects4 interface [Windows Debugging],SetCurrentThreadId method, IDebugSystemObjects4::SetCurrentThreadId, IDebugSystemObjects::SetCurrentThreadId, IDebugSystemObjects_61d7341c-41f8-4971-ad7e-b4fbd5b022b1.xml, SetCurrentThreadId, SetCurrentThreadId method [Windows Debugging], SetCurrentThreadId method [Windows Debugging],IDebugSystemObjects interface, SetCurrentThreadId method [Windows Debugging],IDebugSystemObjects2 interface, SetCurrentThreadId method [Windows Debugging],IDebugSystemObjects3 interface, SetCurrentThreadId method [Windows Debugging],IDebugSystemObjects4 interface, dbgeng/IDebugSystemObjects2::SetCurrentThreadId, dbgeng/IDebugSystemObjects3::SetCurrentThreadId, dbgeng/IDebugSystemObjects4::SetCurrentThreadId, dbgeng/IDebugSystemObjects::SetCurrentThreadId, debugger.setcurrentthreadid	dbgeng.h	Dbgeng.h	Desktop															Windows		IDebugSystemObjects::SetCurrentThreadId dbgeng/IDebugSystemObjects::SetCurrentThreadId	APIRef kbSyntax	COM	dbgeng.h	IDebugSystemObjects::SetCurrentThreadId

IDebugSystemObjects::SetCurrentThreadId

-description

The SetCurrentThreadId method makes the specified thread the current thread.

-parameters

-param Id [in]

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

-returns

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.