Funzione AttachThreadInput (winuser.h)

Articolo
03/04/2024

Collega o scollega il meccanismo di elaborazione di input di un thread a quello di un altro thread.

Sintassi

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

Parametri

[in] idAttach

Identificatore del thread da collegare a un altro thread. Il thread da collegare non può essere un thread di sistema.

[in] idAttachTo

Identificatore del thread a cui verrà collegato idAttach . Questo thread non può essere un thread di sistema.

Un thread non può collegarsi a se stesso. Pertanto , idAttachTo non può essere uguale a idAttach.

[in] fAttach

Se questo parametro è TRUE, i due thread vengono collegati. Se il parametro è FALSE, i thread vengono scollegati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Windows Server 2003 e Windows XP: Non sono presenti informazioni di errore estese; non chiamare GetLastError. Questo comportamento è cambiato a partire da Windows Vista.

Commenti

Usando la funzione AttachThreadInput , un thread può condividere i relativi stati di input (ad esempio stati della tastiera e la finestra dello stato attivo corrente) con un altro thread. Gli eventi della tastiera e del mouse ricevuti da entrambi i thread vengono elaborati nell'ordine in cui sono stati ricevuti fino a quando i thread non vengono scollegati chiamando AttachThreadInput una seconda volta e specificando FALSE per il parametro fAttach .

La funzione AttachThreadInput ha esito negativo se uno dei thread specificati non ha una coda di messaggi. Il sistema crea una coda di messaggi di un thread quando il thread effettua la prima chiamata a una delle funzioni USER o GDI. La funzione AttachThreadInput ha esito negativo anche se è installato un hook di record journal. Journal gli hook di record allegano tutte le code di input insieme.

Si noti che lo stato della chiave, che può essere verificato dalle chiamate alla funzione GetKeyState o GetKeyboardState , viene reimpostata dopo una chiamata a AttachThreadInput. Non è possibile collegare un thread a un thread in un altro desktop.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)