Fungsi Thread32First (tlhelp32.h)

Artikel
03/02/2024

Mengambil informasi tentang utas pertama dari proses apa pun yang ditemui dalam rekam jepret sistem.

Sintaks

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

Parameter

[in] hSnapshot

Handel ke rekam jepret yang dikembalikan dari panggilan sebelumnya ke fungsi CreateToolhelp32Snapshot .

[in, out] lpte

Penunjuk ke struktur THREADENTRY32 .

Nilai kembali

Mengembalikan TRUE jika entri pertama daftar utas telah disalin ke buffer atau FALSE sebaliknya. Nilai kesalahan ERROR_NO_MORE_FILES dikembalikan oleh fungsi GetLastError jika tidak ada utas atau rekam jepret tidak berisi informasi utas.

Keterangan

Aplikasi panggilan harus mengatur anggota dwSizedari THREADENTRY32 ke ukuran, dalam byte, dari struktur. Thread32First mengubah dwSize ke jumlah byte yang ditulis ke struktur. Ini tidak akan pernah lebih besar dari nilai awal dwSize, tetapi mungkin lebih kecil. Jika nilainya lebih kecil, jangan mengandalkan nilai anggota mana pun yang offsetnya lebih besar dari nilai ini.

Untuk mengambil informasi tentang utas lain yang direkam dalam rekam jepret yang sama, gunakan fungsi Thread32Next .

Contoh

Misalnya, lihat Melintas Daftar Utas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	tlhelp32.h
Pustaka	Kernel32.lib
DLL	Kernel32.dll