GetThreadContext, fonction (processthreadsapi.h)

Article
03/01/2024

Récupère le contexte du thread spécifié.

Une application 64 bits peut récupérer le contexte d’un thread WOW64 à l’aide de Wow64GetThreadContext.

Syntaxe

BOOL GetThreadContext(
  [in]      HANDLE    hThread,
  [in, out] LPCONTEXT lpContext
);

Paramètres

[in] hThread

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

Windows XP ou Windows Server 2003 : Le handle doit également avoir un accès THREAD_QUERY_INFORMATION .

[in, out] lpContext

Pointeur vers une structure CONTEXT (telle que ARM64_NT_CONTEXT) qui reçoit le contexte approprié du thread spécifié. La valeur du membre ContextFlags de cette structure spécifie les parties du contexte d’un thread qui sont récupérées. La structure CONTEXT est très spécifique au processeur. Reportez-vous au fichier d’en-tête WinNT.h pour connaître les définitions spécifiques au processeur de ces structures et les exigences d’alignement.

Valeur retournée

Si la fonction réussit, 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.

Remarques

Cette fonction est utilisée pour récupérer le contexte de thread du thread spécifié. La fonction récupère un contexte sélectif basé sur 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 lorsque le thread n’est pas débogué.

Vous ne pouvez pas obtenir un contexte valide pour un thread en cours d’exécution. Utilisez la fonction SuspendThread pour suspendre le thread avant d’appeler GetThreadContext.

Si vous appelez GetThreadContext pour le thread actuel, la fonction retourne correctement ; toutefois, le contexte retourné n’est pas valide.

Configuration requise

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

Partager via