Wow64GetThreadContext, fonction (wow64apiset.h)

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

Syntaxe

BOOL Wow64GetThreadContext(
  [in]      HANDLE         hThread,
  [in, out] PWOW64_CONTEXT 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.

[in, out] lpContext

Structure WOW64_CONTEXT . L’appelant doit initialiser le membre ContextFlags de cette structure.

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’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 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 Wow64SuspendThread pour suspendre le thread avant d’appeler Wow64GetThreadContext.

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

Cette fonction est destinée aux applications 64 bits. Il n’est pas pris en charge sur Windows 32 bits ; ces appels échouent et définissent le dernier code d’erreur sur ERROR_INVALID_FUNCTION. Une application 32 bits peut appeler cette fonction sur un thread WOW64 ; le résultat est identique à l’appel de la fonction GetThreadContext .

Spécifications

Voir aussi

débogage des fonctions

GetThreadContext, fonction

GetXStateFeaturesMask

WOW64_CONTEXT

Wow64SetThreadContext