Heap32ListFirst-Funktion (tlhelp32.h)

Artikel
03/02/2024

Ruft Informationen zum ersten Heap ab, der von einem angegebenen Prozess zugeordnet wurde.

Syntax

BOOL Heap32ListFirst(
  [in]      HANDLE       hSnapshot,
  [in, out] LPHEAPLIST32 lphl
);

Parameter

[in] hSnapshot

Ein Handle für die Momentaufnahme von einem vorherigen Aufruf der CreateToolhelp32Snapshot-Funktion zurückgegeben.

[in, out] lphl

Ein Zeiger auf eine HEAPLIST32-Struktur .

Rückgabewert

Gibt TRUE zurück, wenn der erste Eintrag der Heapliste in den Puffer kopiert wurde, oder andernfalls FALSE . Der ERROR_NO_MORE_FILES Fehlerwert wird von der GetLastError-Funktion zurückgegeben, wenn keine Heapliste vorhanden ist oder die Momentaufnahme keine Heaplisteninformationen enthält.

Hinweise

Die aufrufende Anwendung muss den dwSize-Member von HEAPLIST32 auf die Größe der Struktur in Bytes festlegen. Heap32ListFirst ändert dwSize in die Anzahl der Bytes, die in die Struktur geschrieben werden. Dies ist niemals größer als der Anfangswert von dwSize, kann aber kleiner sein. Wenn der Wert kleiner ist, verlassen Sie sich nicht auf die Werte von Membern, deren Offsets größer als dieser Wert sind.

Verwenden Sie die Heap32ListNext-Funktion , um Informationen zu anderen Heaps in der Heapliste abzurufen.

Beispiele

Ein Beispiel finden Sie unter Durchlaufen der Heapliste.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tlhelp32.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll