Heap32Next-Funktion (tlhelp32.h)
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 |