Bagikan melalui


Fungsi Thread32First (tlhelp32.h)

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

Lihat juga

CreateToolhelp32Snapshot

THREADENTRY32

Berjalan di Utas

Thread32Next

Fungsi Bantuan Alat