Wow64GetThreadSelectorEntry function (winbase.h)

Retrieves a descriptor table entry for the specified selector and WOW64 thread.

Syntax

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

Parameters

[in] hThread

A handle to the thread containing the specified selector. The handle must have been created with THREAD_QUERY_INFORMATION access to the thread. For more information, see Thread Security and Access Rights.

[in] dwSelector

The global or local selector value to look up in the thread's descriptor tables.

[out] lpSelectorEntry

A pointer to a WOW64_LDT_ENTRY structure that receives a copy of the descriptor table entry if the specified selector has an entry in the specified thread's descriptor table. This information can be used to convert a segment-relative address to a linear virtual address.

Return value

If the function succeeds, the return value is nonzero. In that case, the structure pointed to by the lpSelectorEntry parameter receives a copy of the specified descriptor table entry.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The Wow64GetThreadSelectorEntry function is functional only on 64-bit systems and can be called only by 64-bit processes. If this function is called by a 32-bit process, the function fails with ERROR_NOT_SUPPORTED. A 32-bit process should use the GetThreadSelectorEntry function instead.

Debuggers use this function to convert segment-relative addresses to linear virtual addresses. The ReadProcessMemory and WriteProcessMemory functions use linear virtual addresses.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll