Função GetThreadSelectorEntry (winbase.h)

Recupera uma entrada da tabela do descritor para o seletor e o thread especificados.

Sintaxe

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

Parâmetros

[in] hThread

Um identificador para o thread que contém o seletor especificado. O identificador deve ter acesso THREAD_QUERY_INFORMATION. Para obter mais informações, consulte Segurança de thread e direitos de acesso.

[in] dwSelector

O valor do seletor global ou local a ser pesquisado nas tabelas de descritor do thread.

[out] lpSelectorEntry

Um ponteiro para uma estrutura LDT_ENTRY que recebe uma cópia da entrada da tabela do descritor se o seletor especificado tiver uma entrada na tabela descritor do thread especificado. Essas informações podem ser usadas para converter um endereço relativo ao segmento em um endereço virtual linear.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. Nesse caso, a estrutura apontada pelo parâmetro lpSelectorEntry recebe uma cópia da entrada de tabela de descritor especificada.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

GetThreadSelectorEntry só funciona em sistemas baseados em x86. Para sistemas que não são baseados em x86, a função retorna FALSE.

Os depuradores usam essa função para converter endereços relativos ao segmento em endereços virtuais lineares. As funções ReadProcessMemory e WriteProcessMemory usam endereços virtuais lineares.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Funções de depuração

LDT_ENTRY

ReadProcessMemory

WriteProcessMemory