Fungsi Heap32First (tlhelp32.h)
Mengambil informasi tentang blok pertama timbunan yang telah dialokasikan oleh proses.
Sintaks
BOOL Heap32First(
[in, out] LPHEAPENTRY32 lphe,
[in] DWORD th32ProcessID,
[in] ULONG_PTR th32HeapID
);
Parameter
[in, out] lphe
Penunjuk ke struktur HEAPENTRY32 .
[in] th32ProcessID
Pengidentifikasi konteks proses yang memiliki timbunan.
[in] th32HeapID
Pengidentifikasi tumpukan yang akan dijumlahkan.
Menampilkan nilai
Mengembalikan TRUE jika informasi untuk blok heap pertama telah disalin ke buffer atau FALSE jika tidak. Nilai kesalahan ERROR_NO_MORE_FILES dikembalikan oleh fungsi GetLastError jika heap tidak valid atau kosong.
Keterangan
Aplikasi panggilan harus mengatur anggota dwSizeHEAPENTRY32 ke ukuran, dalam byte, dari struktur. Heap32First mengubah dwSize menjadi 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 mengakses blok berikutnya dari heap yang sama, gunakan fungsi Heap32Next .
Berjalan timbunan dengan Heap32First dan Heap32Next tidak efisien, terutama untuk timbunan besar. Gunakan HeapWalk sebagai gantinya.
Contoh
Misalnya, lihat Melintas Daftar Heap.
Persyaratan
| 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 |