GetThreadSelectorEntry-Funktion (winbase.h)

Artikel
08/27/2023

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

Syntax

BOOL GetThreadSelectorEntry(
  [in]  HANDLE      hThread,
  [in]  DWORD       dwSelector,
  [out] LPLDT_ENTRY lpSelectorEntry
);

Parameter

[in] hThread

Ein Handle für den Thread, der den angegebenen Selektor enthält. Das Handle muss über THREAD_QUERY_INFORMATION Zugriff verfügen. 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 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 lpSelectorEntry-Parameter 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

GetThreadSelectorEntry ist nur auf x86-basierten Systemen funktionsfähig. Für Systeme, die nicht x86-basiert sind, gibt die Funktion FALSE zurück.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch