Thread32First 関数 (tlhelp32.h)

システム スナップショットで検出されたすべてのプロセスの最初のスレッドに関する情報を取得します。

構文

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

パラメーター

[in] hSnapshot

CreateToolhelp32Snapshot 関数の以前の呼び出しから返されたスナップショットへのハンドル。

[in, out] lpte

THREADENTRY32構造体へのポインター。

戻り値

スレッド リストの最初のエントリがバッファーにコピーされた場合は TRUE 、それ以外の場合は FALSE を 返します。 スレッドが存在しない場合、またはスナップショットにスレッド情報が含まれていない場合、ERROR_NO_MORE_FILESエラー値は GetLastError 関数によって返されます。

注釈

呼び出し元のアプリケーションでは、THREADENTRY32 の dwSize メンバーを構造体のサイズ (バイト単位) に設定する必要があります。 Thread32First は 、dwSize を 構造体に書き込まれたバイト数に変更します。 これは dwSize の初期値を超えることはありませんが、小さい場合があります。 値が小さい場合は、オフセットがこの値より大きいメンバーの値に依存しないでください。

同じスナップショットに記録されている他のスレッドに関する情報を取得するには、Thread32Next 関数を使用します。

例

例については、「 スレッド リストの走査」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	tlhelp32.h
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

CreateToolhelp32Snapshot

THREADENTRY32

スレッド ウォーキング

Thread32Next

ツール ヘルプ関数