Partager via

GetThreadContext, fonction (processthreadsapi.h)

  • Article

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 la Wow64GetThreadContext.

Syntaxe

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

Paramètres

[in] hThread

Handle vers le 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 ContextFlags membre de cette structure spécifie quelles parties du contexte d’un thread 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 de retour

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’erreur étendues, 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 en fonction de la valeur du ContextFlags membre 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows XP [applications de bureau | Applications UWP]
serveur minimum pris en charge Windows Server 2003 [applications de bureau | Applications UWP]
plateforme cible Windows
d’en-tête processthreadsapi.h (include Windows.h)
bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi