Fungsi Heap32First (tlhelp32.h)

  • Artikel

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

Lihat juga

HEAPENTRY32

Daftar Timbunan dan Heap Walking

Heap32Next

Fungsi Bantuan Alat