Thread32First

システムスナップショット内で見つかった最初のスレッドの情報を取得する。

Thread32First hSnapshot, lpte

hSnapshot : [intptr] CreateToolhelp32Snapshot の前回呼び出しから返されたスナップショットへのハンドル。
lpte : [var] THREADENTRY32 構造体へのポインタ。

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

解説

システムスナップショット内で見つかった最初のスレッドの情報を取得する。

[戻り値]
スレッドリストの最初のエントリがバッファにコピーされた場合は TRUE、そうでなければ FALSE
を返す。スレッドが存在しないかスナップショットにスレッド情報が含まれない場合、GetLastError は
ERROR_NO_MORE_FILES を返す。

[備考]
呼び出し側アプリケーションは THREADENTRY32 の dwSize メンバに構造体のバイト数を設定する。Thread32First
は dwSize を構造体に書き込んだバイト数に変更する。これは初期 dwSize
の値より大きくなることはなく、小さくなることがある。値が小さい場合、それより大きいオフセットを持つメンバ値に依存しないこと。同一スナップショットに記録された他のスレッド情報を取得するには
Thread32Next を使う。

情報

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