Méthode IDebugSystemObjects3 ::SetCurrentThreadId (dbgeng.h)

  • Article

La méthode SetCurrentThreadId fait du thread spécifié le thread actuel.

Syntaxe

HRESULT SetCurrentThreadId(
  [in] ULONG Id
);

Paramètres

[in] Id

Spécifie l’ID de thread de moteur du thread qui doit devenir le thread actuel.

Valeur retournée

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour .

Code de retour Description
S_OK
 La méthode a réussi.
E_NOINTERFACE
 Aucun thread avec l’ID spécifié n’a été trouvé.

Remarques

Cette méthode peut également modifier le processus actuel, la cible actuelle et l’ordinateur actuel.

Si le thread est modifié, le rappel IDebugEventCallbacks ::ChangeEngineState est appelé avec le DEBUG_CES_CURRENT_THREAD bit défini.

Note Dans le débogage en mode noyau, le thread actuel est un thread virtuel. Il ne s’agit pas d’un thread système. Cette méthode ne peut pas être utilisée pour changer entre les threads système dans le débogage en mode noyau. Toutefois, le thread implicite peut être modifié à l’aide de SetImplicitThreadDataOffset.
 
Pour plus d’informations sur les threads, consultez Threads and Processes. Pour plus d’informations sur les événements de surveillance, consultez Surveillance des événements.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)