Heap32Next-Funktion (tlhelp32.h)

Artikel
03/06/2024

Ruft Informationen zum nächsten Block eines Heaps ab, der von einem Prozess zugeordnet wurde.

Syntax

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Parameter

[out] lphe

Ein Zeiger auf eine HEAPENTRY32-Struktur .

Rückgabewert

Gibt TRUE zurück, wenn Informationen zum nächsten Block im Heap in den Puffer kopiert wurden, oder andernfalls FALSE . Die GetLastError-Funktion gibt ERROR_NO_MORE_FILES zurück, wenn keine weiteren Objekte im Heap vorhanden sind, und ERROR_INVALID_DATA , wenn der Heap beschädigt zu sein scheint oder während des Exemplars so geändert wird, dass Heap32Next nicht fortgesetzt werden kann.

Hinweise

Verwenden Sie die Heap32First-Funktion , um Informationen für den ersten Block eines Heaps abzurufen.

Die Heap32Next-Funktion verwaltet keinen Verweis auf den Zielprozess. Wenn der Zielprozess stirbt, erstellt das System möglicherweise einen neuen Prozess mit demselben Prozessbezeichner. Daher sollte der Aufrufer einen Verweis auf den Zielprozess beibehalten, solange heap32Next verwendet wird.

Das Durchlaufen des Heaps mit Heap32First und Heap32Next ist insbesondere bei großen Heaps ineffizient. Verwenden Sie stattdessen HeapWalk .

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