AttachThreadInput 関数 (winuser.h)

[アーティクル]
03/04/2024

あるスレッドの入力処理メカニズムを別のスレッドの入力処理メカニズムにアタッチまたはデタッチします。

構文

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

パラメーター

[in] idAttach

別のスレッドにアタッチするスレッドの識別子。アタッチするスレッドをシステムスレッドにすることはできません。

[in] idAttachTo

idAttach がアタッチされるスレッドの識別子。このスレッドをシステムスレッドにすることはできません。

スレッドはそれ自体にアタッチできません。したがって、 idAttachTo はidAttach と等しくできません。

[in] fAttach

このパラメーターが TRUE の場合、2 つのスレッドがアタッチされます。パラメーターが FALSE の場合、スレッドはデタッチされます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

Windows Server 2003 および Windows XP: 拡張エラー情報はありません。 GetLastError を呼び出さないでください。この動作は、Windows Vista の時点で変更されました。

注釈

AttachThreadInput 関数を使用すると、スレッドは入力状態 (キーボードの状態や現在のフォーカスウィンドウなど) を別のスレッドと共有できます。両方のスレッドで受信したキーボードイベントとマウスイベントは、スレッドがデタッチされるまで、受け取った順序で処理されます。これは、AttachThreadInput を 2 回目に呼び出し、fAttach パラメーターに FALSE を指定することで行われます。

指定したスレッドのいずれかにメッセージキューがない場合、 AttachThreadInput 関数は失敗します。システムは、スレッドが USER 関数または GDI 関数の 1 つを最初に呼び出すときに、スレッドのメッセージキューを作成します。ジャーナルレコードフックがインストールされている場合、 AttachThreadInput 関数も失敗します。ジャーナルレコードフックは、すべての入力キューを一緒に接続します。

GetKeyState 関数または GetKeyboardState 関数の呼び出しによって確認できるキー状態は、AttachThreadInput の呼び出し後にリセットされることに注意してください。スレッドを別のデスクトップのスレッドにアタッチすることはできません。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-misc-l1-2-0 (Windows 8.1で導入)