GetGUIThreadInfo

アクティブウィンドウまたは指定した GUI スレッドに関する情報を取得する。

GetGUIThreadInfo idThread, pgui

idThread : [int] 型: DWORD 情報を取得するスレッドの識別子。この値を取得するには GetWindowThreadProcessId 関数を使用する。このパラメータが NULL の場合、関数はフォアグラウンドスレッドの情報を返す。
pgui : [var] 型: LPGUITHREADINFO スレッドを記述する情報を受け取る GUITHREADINFO 構造体へのポインタ。この関数を呼び出す前に cbSize メンバーを sizeof(GUITHREADINFO) に設定しなければならないことに注意。

(プラグイン / モジュール : user32.dll)

解説

アクティブウィンドウまたは指定した GUI スレッドに関する情報を取得する。

[戻り値]
型: BOOL 関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]

アクティブウィンドウが呼び出し元プロセスによって所有されていない場合でもこの関数は成功する。指定したスレッドが存在しないか入力キューを持たない場合、関数は失敗する。

情報

プラグイン / モジュールuser32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の user32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_user32_gen2.hs