Fonction Wow64GetThreadSelectorEntry (winbase.h)

Article
03/03/2024

Récupère une entrée de table de descripteur pour le sélecteur et le thread WOW64 spécifiés.

Syntaxe

BOOL Wow64GetThreadSelectorEntry(
  [in]  HANDLE           hThread,
  [in]  DWORD            dwSelector,
  [out] PWOW64_LDT_ENTRY lpSelectorEntry
);

Paramètres

[in] hThread

Handle du thread contenant le sélecteur spécifié. Le handle doit avoir été créé avec THREAD_QUERY_INFORMATION accès au thread. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

[in] dwSelector

Valeur de sélecteur global ou local à rechercher dans les tables de descripteur du thread.

[out] lpSelectorEntry

Pointeur vers une structure de WOW64_LDT_ENTRY qui reçoit une copie de l’entrée de la table de descripteur si le sélecteur spécifié a une entrée dans la table de descripteur du thread spécifié. Ces informations peuvent être utilisées pour convertir une adresse relative de segment en adresse virtuelle linéaire.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro. Dans ce cas, la structure pointée vers le paramètre lpSelectorEntry reçoit une copie de l’entrée de table de descripteur spécifiée.

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

La fonction Wow64GetThreadSelectorEntry est uniquement fonctionnelle sur les systèmes 64 bits et ne peut être appelée que par les processus 64 bits. Si cette fonction est appelée par un processus 32 bits, la fonction échoue avec ERROR_NOT_SUPPORTED. Un processus 32 bits doit utiliser la fonction GetThreadSelectorEntry à la place.

Les débogueurs utilisent cette fonction pour convertir des adresses relatives aux segments en adresses virtuelles linéaires. Les fonctions ReadProcessMemory et WriteProcessMemory utilisent des adresses virtuelles linéaires.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Partager via