Funzione Heap32ListFirst (tlhelp32.h)

Recupera informazioni sul primo heap allocato da un processo specificato.

Sintassi

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

Parametri

[in] hSnapshot

Handle per lo snapshot restituito da una chiamata precedente alla funzione CreateToolhelp32Snapshot .

[in, out] lphl

Puntatore a una struttura HEAPLIST32 .

Valore restituito

Restituisce TRUE se la prima voce dell'elenco heap è stata copiata nel buffer o false in caso contrario. Il valore di errore ERROR_NO_MORE_FILES viene restituito dalla funzione GetLastError quando non esiste alcun elenco heap o lo snapshot non contiene informazioni sull'elenco heap.

Commenti

L'applicazione chiamante deve impostare il membro dwSize di HEAPLIST32 sulle dimensioni, in byte, della struttura. Heap32ListFirst cambia dwSize nel numero di byte scritti nella struttura. Questo non sarà mai maggiore del valore iniziale di dwSize, ma potrebbe essere più piccolo. Se il valore è più piccolo, non si basano sui valori di tutti i membri i cui offset sono maggiori di questo valore.

Per recuperare informazioni su altri heaps nell'elenco heap, usare la funzione Heap32ListNext .

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

CreateToolhelp32Snapshot

HEAPLIST32

Heap Elenchi e Heap Walking

Heap32ListNext

Funzioni della Guida degli strumenti