Fungsi Heap32Next (tlhelp32.h)
Mengambil informasi tentang blok berikutnya dari timbunan yang telah dialokasikan oleh proses.
Sintaks
BOOL Heap32Next(
[out] LPHEAPENTRY32 lphe
);
Parameter
[out] lphe
Penunjuk ke struktur HEAPENTRY32 .
Nilai kembali
Mengembalikan TRUE jika informasi tentang blok berikutnya dalam heap telah disalin ke buffer atau FALSE jika tidak. Fungsi GetLastError mengembalikan ERROR_NO_MORE_FILES ketika tidak ada lagi objek di tumpukan yang ada dan ERROR_INVALID_DATA jika tumpukan tampaknya rusak atau dimodifikasi selama berjalan sewaktu-waktu sehingga Heap32Next tidak dapat dilanjutkan.
Keterangan
Untuk mengambil informasi untuk blok pertama heap, gunakan fungsi Heap32First .
Fungsi Heap32Next tidak mempertahankan referensi ke proses target. Jika proses target mati, sistem dapat membuat proses baru menggunakan pengidentifikasi proses yang sama. Oleh karena itu, penelepon harus mempertahankan referensi ke proses target selama menggunakan Heap32Next.
Berjalan di timbunan dengan Heap32First dan Heap32Next tidak efisien, terutama untuk timbunan besar. Gunakan HeapWalk sebagai gantinya.
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 |