Condividi tramite


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

Vedere anche

HEAPENTRY32

Heap Elenchi e Heap Walking

Heap32First

Funzioni della Guida degli strumenti