SetThreadContext, fonction (processthreadsapi.h)

Article
08/25/2023

Définit le contexte du thread spécifié.

Une application 64 bits peut définir le contexte d’un thread WOW64 à l’aide de la fonction Wow64SetThreadContext .

Syntaxe

BOOL SetThreadContext(
  [in] HANDLE        hThread,
  [in] const CONTEXT *lpContext
);

Paramètres

[in] hThread

Handle du thread dont le contexte doit être défini. Le handle doit avoir le droit d’accès THREAD_SET_CONTEXT au thread. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

[in] lpContext

Pointeur vers une structure CONTEXT qui contient le contexte à définir dans le thread spécifié. La valeur du membre ContextFlags de cette structure spécifie les parties du contexte d’un thread à définir. Certaines valeurs de la structure CONTEXT qui ne peuvent pas être spécifiées sont définies en mode silencieux sur la valeur correcte. Cela inclut les bits du registre de status processeur qui spécifient le mode processeur privilégié, les bits d’activation globale dans le registre de débogage et d’autres états qui doivent être contrôlés par le système d’exploitation.

Valeur retournée

Si le contexte a été défini, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

La fonction définit le contexte de thread en fonction de la valeur du membre ContextFlags de la structure de contexte. Le thread identifié par le paramètre hThread est généralement débogué, mais la fonction peut également fonctionner même lorsque le thread n’est pas débogué.

N’essayez pas de définir le contexte d’un thread en cours d’exécution ; les résultats sont imprévisibles. Utilisez la fonction SuspendThread pour suspendre le thread avant d’appeler SetThreadContext.

Spécifications


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll