Fungsi Heap32Next (tlhelp32.h)

  • Artikel

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

Lihat juga

HEAPENTRY32

Heap Lists dan Heap Walking

Heap32Dirst

Fungsi Bantuan Alat