Bagikan melalui


Fungsi Heap32ListFirst (tlhelp32.h)

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

Lihat juga

CreateToolhelp32Snapshot

HEAPLIST32

Heap Lists dan Heap Walking

Heap32ListNext

Fungsi Bantuan Alat