Wow64GetThreadSelectorEntry-Funktion (winbase.h)

Artikel
08/27/2023

Ruft einen Deskriptortabelleneintrag für den angegebenen Selektor und WOW64-Thread ab.

Syntax

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

Parameter

[in] hThread

Ein Handle für den Thread, der den angegebenen Selektor enthält. Das Handle muss mit THREAD_QUERY_INFORMATION Zugriff auf den Thread erstellt worden sein. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

[in] dwSelector

Der globale oder lokale Selektorwert, der in den Deskriptortabellen des Threads nachschlagen soll.

[out] lpSelectorEntry

Ein Zeiger auf eine WOW64_LDT_ENTRY Struktur, die eine Kopie des Deskriptortabelleneintrags empfängt, wenn der angegebene Selektor über einen Eintrag in der Deskriptortabelle des angegebenen Threads verfügt. Diese Informationen können verwendet werden, um eine segmentrelative Adresse in eine lineare virtuelle Adresse zu konvertieren.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. In diesem Fall empfängt die Struktur, auf die der parameter lpSelectorEntry verweist, eine Kopie des angegebenen Deskriptortabelleneintrags.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Wow64GetThreadSelectorEntry-Funktion funktioniert nur auf 64-Bit-Systemen und kann nur von 64-Bit-Prozessen aufgerufen werden. Wenn diese Funktion von einem 32-Bit-Prozess aufgerufen wird, schlägt die Funktion mit ERROR_NOT_SUPPORTED fehl. Ein 32-Bit-Prozess sollte stattdessen die GetThreadSelectorEntry-Funktion verwenden.

Debugger verwenden diese Funktion, um segmentrelative Adressen in lineare virtuelle Adressen zu konvertieren. Die Funktionen ReadProcessMemory und WriteProcessMemory verwenden lineare virtuelle Adressen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Freigeben über