AttachThreadInput-Funktion (winuser.h)

Artikel
08/27/2023

Fügt den Eingabeverarbeitungsmechanismus eines Threads an den eines anderen Threads an oder trennt diesen.

Syntax

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

Parameter

[in] idAttach

Der Bezeichner des Threads, der an einen anderen Thread angefügt werden soll. Der anzufügende Thread darf kein Systemthread sein.

[in] idAttachTo

Der Bezeichner des Threads, an den idAttach angefügt wird. Dieser Thread darf kein Systemthread sein.

Ein Thread kann sich nicht an sich selbst anfügen. Daher kann idAttachTo nicht gleich idAttach sein.

[in] fAttach

Wenn dieser Parameter TRUE ist, werden die beiden Threads angefügt. Wenn der Parameter FALSE ist, werden die Threads getrennt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Windows Server 2003 und Windows XP: Es gibt keine erweiterten Fehlerinformationen. Rufen Sie GetLastError nicht auf. Dieses Verhalten hat sich ab Windows Vista geändert.

Hinweise

Mithilfe der AttachThreadInput-Funktion kann ein Thread seine Eingabezustände (z. B. Tastaturzustände und das aktuelle Fokusfenster) für einen anderen Thread freigeben. Tastatur- und Mausereignisse, die von beiden Threads empfangen werden, werden in der Reihenfolge verarbeitet, in der sie empfangen wurden, bis die Threads getrennt werden, indem AttachThreadInput ein zweites Mal aufgerufen und FALSE für den fAttach-Parameter angegeben wird.

Die AttachThreadInput-Funktion schlägt fehl, wenn einer der angegebenen Threads keine Nachrichtenwarteschlange enthält. Das System erstellt die Nachrichtenwarteschlange eines Threads, wenn der Thread zum ersten Mal eine der USER- oder GDI-Funktionen aufruft. Die AttachThreadInput-Funktion schlägt auch fehl, wenn ein Journaldatensatz-Hook installiert ist. Journal Datensatzhaken alle Eingabewarteschlangen anfügen.

Beachten Sie, dass der Schlüsselzustand, der durch Aufrufe der Funktion GetKeyState oder GetKeyboardState ermittelt werden kann, nach einem Aufruf von AttachThreadInput zurückgesetzt wird. Sie können keinen Thread an einen Thread auf einem anderen Desktop anfügen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)