Função AttachThreadInput (winuser.h)

Artigo
03/13/2024

Anexa ou desanexa o mecanismo de processamento de entrada de um thread ao de outro thread.

Sintaxe

BOOL AttachThreadInput(
  [in] DWORD idAttach,
  [in] DWORD idAttachTo,
  [in] BOOL  fAttach
);

Parâmetros

[in] idAttach

O identificador do thread a ser anexado a outro thread. O thread a ser anexado não pode ser um thread do sistema.

[in] idAttachTo

O identificador do thread ao qual idAttach será anexado. Esse thread não pode ser um thread do sistema.

Um thread não pode ser anexado a si mesmo. Portanto, idAttachTo não pode ser igual a idAttach.

[in] fAttach

Se esse parâmetro for TRUE, os dois threads serão anexados. Se o parâmetro for FALSE, os threads serão desanexados.

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.

Windows Server 2003 e Windows XP: Não há informações de erro estendidas; não chame GetLastError. Esse comportamento mudou a partir do Windows Vista.

Comentários

Usando a função AttachThreadInput , um thread pode compartilhar seus estados de entrada (como estados de teclado e a janela de foco atual) com outro thread. Os eventos de teclado e mouse recebidos por ambos os threads são processados na ordem em que foram recebidos até que os threads sejam desanexados chamando AttachThreadInput uma segunda vez e especificando FALSE para o parâmetro fAttach .

A função AttachThreadInput falhará se um dos threads especificados não tiver uma fila de mensagens. O sistema cria a fila de mensagens de um thread quando o thread faz sua primeira chamada para uma das funções USER ou GDI. A função AttachThreadInput também falhará se um gancho de registro de diário estiver instalado. Diário ganchos de registro anexam todas as filas de entrada.

Observe que o estado da chave, que pode ser apurado por chamadas para a função GetKeyState ou GetKeyboardState , é redefinido após uma chamada para AttachThreadInput. Você não pode anexar um thread a um thread em outra área de trabalho.

Requisitos

Requisito	Valor
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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-misc-l1-2-0 (introduzido em Windows 8.1)