Thread32First

Declare Function Api_Thread32First& Lib "kernel32" Alias "Thread32First" (ByVal hSnapshot&, lppe As THREADENTRY32)

Declare Function Thread32First Lib "kernel32" (ByVal hSnapshot As Long, lppe As THREADENTRY32) As Long

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

パラメータ
hSnapshot
    直前に CreateToolhelp32Snapshot 関数を呼び出したときに返されたスナップショットのハンドルを指定する。
lpte
    THREADENTRY32 構造体へのポインタを指定する。

戻り値
    スレッドリストの最初のエントリがバッファへコピーされた場合は、TRUE が返る。

    それ以外の場合は、FALSE が返る。スレッドが存在しない場合や、スナップショットがスレッド情報を保持していない場合は、

    GetLastError 関数は ERROR_NO_MORE_FILES エラー値を返す。

解説
    呼び出し側のアプリケーションは、THREADENTRY32 構造体の dwSize メンバを、この構造体のバイト単位のサイズに設定しなければな

    らない。

    Thread32First 関数は dwSize メンバを、この構造体に書き込まれたバイト数に変更する。

    後者の値は、dwSize メンバの最初の値を上回ることはないが、それより小さくなることはある。

    後者の値が最初の値より小さくなっていた場合、後者の値を上回るオフセット値を持つメンバの値を信頼しないこと。
    同じスナップショットに記録されている他のスレッドに関する情報を取得するには、Thread32Next 関数を使う。