Fungsi Heap32ListFirst (tlhelp32.h)

Artikel
03/04/2024

Mengambil informasi tentang timbunan pertama yang telah dialokasikan oleh proses tertentu.

Sintaks

BOOL Heap32ListFirst(
  [in]      HANDLE       hSnapshot,
  [in, out] LPHEAPLIST32 lphl
);

Parameter

[in] hSnapshot

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

[in, out] lphl

Penunjuk ke struktur HEAPLIST32 .

Nilai kembali

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

Keterangan

Aplikasi panggilan harus mengatur anggota dwSizedari HEAPLIST32 ke ukuran, dalam byte, dari struktur. Heap32ListFirst 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 timbunan lain dalam daftar heap, gunakan fungsi Heap32ListNext .

Contoh

Misalnya, lihat Melintas Daftar Timbunan.

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