Funzione Heap32Next (tlhelp32.h)
Recupera informazioni sul blocco successivo di un heap allocato da un processo.
Sintassi
BOOL Heap32Next(
[out] LPHEAPENTRY32 lphe
);
Parametri
[out] lphe
Puntatore a una struttura HEAPENTRY32 .
Valore restituito
Restituisce TRUE se le informazioni sul blocco successivo nell'heap sono state copiate nel buffer o FALSE in caso contrario. La funzione GetLastError restituisce ERROR_NO_MORE_FILES quando non esistono più oggetti nell'heap e ERROR_INVALID_DATA se l'heap sembra essere danneggiato o modificato durante la procedura dettagliata in modo che Heap32Next non possa continuare.
Commenti
Per recuperare informazioni per il primo blocco di un heap, usare la funzione Heap32First .
La funzione Heap32Next non mantiene un riferimento al processo di destinazione. Se il processo di destinazione muore, il sistema può creare un nuovo processo usando lo stesso identificatore del processo. Pertanto, il chiamante deve mantenere un riferimento al processo di destinazione purché usi Heap32Next.
Camminare l'heap con Heap32First e Heap32Next è inefficiente, in particolare per gli heap di grandi dimensioni. Usare invece HeapWalk .
Esempio
Per un esempio, vedere Attraversamento dell'elenco heap.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | tlhelp32.h |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |