SetThreadContext, fonction (processthreadsapi.h)
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 |