Compartilhar via


Função GetThreadInformation (processthreadsapi.h)

Recupera informações sobre o thread especificado.

Sintaxe

BOOL GetThreadInformation(
  [in] HANDLE                   hThread,
  [in] THREAD_INFORMATION_CLASS ThreadInformationClass,
       LPVOID                   ThreadInformation,
  [in] DWORD                    ThreadInformationSize
);

Parâmetros

[in] hThread

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

[in] ThreadInformationClass

A classe de informações a ser recuperada. Esse valor pode ser ThreadMemoryPriority, ThreadAbsoluteCpuPriority ou ThreadDynamicCodePolicy.

Observação

O ThreadDynamicCodePolicy tem suporte em Windows Server 2016 e mais recentes, Windows 10 LTSB 2016 e mais recentes e Windows 10 versão 1607 e mais recente.

ThreadInformation

Ponteiro para uma estrutura para receber o tipo de informação especificado pelo parâmetro ThreadInformationClass .

Se o parâmetro ThreadInformationClass for ThreadMemoryPriority, esse parâmetro deverá apontar para uma estrutura MEMORY_PRIORITY_INFORMATION .

Se o parâmetro ThreadInformationClass for ThreadAbsoluteCpuPriority, esse parâmetro deverá apontar para um LONG.

Se o parâmetro ThreadInformationClass for ThreadDynamicCodePolicy, esse parâmetro deverá apontar para um DWORD.

[in] ThreadInformationSize

O tamanho em bytes da estrutura especificada pelo parâmetro ThreadInformation .

Se o parâmetro ThreadInformationClass for ThreadMemoryPriority, esse parâmetro deverá ser sizeof(MEMORY_PRIORITY_INFORMATION).

Se o parâmetro ThreadInformationClass for ThreadAbsoluteCpuPriority, esse parâmetro deverá ser sizeof(LONG).

Se o parâmetro ThreadInformationClass for ThreadDynamicCodePolicy, esse parâmetro deverá ser sizeof(DWORD).

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Requisitos

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

Confira também

GetProcessInformation, SetThreadInformation