SetThreadContext, fonction (processthreadsapi.h)

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

Syntaxe

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

Paramètres

[in] hThread

Handle vers le 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 des bits dans le registre d’état du processeur qui spécifient le mode processeur privilégié, les bits d’activation globaux 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’erreur étendues, appelez GetLastError.

Remarques

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

Voir aussi

CONTEXTE

débogage des fonctions

GetThreadContext

GetXStateFeaturesMask

SetXStateFeaturesMask

SuspendThread