Funzione Heap32First (tlhelp32.h)
Recupera informazioni sul primo blocco di un heap allocato da un processo.
Sintassi
BOOL Heap32First(
[in, out] LPHEAPENTRY32 lphe,
[in] DWORD th32ProcessID,
[in] ULONG_PTR th32HeapID
);
Parametri
[in, out] lphe
Puntatore a una struttura HEAPENTRY32 .
[in] th32ProcessID
Identificatore del contesto del processo proprietario dell'heap.
[in] th32HeapID
Identificatore dell'heap da enumerare.
Valore restituito
Restituisce TRUE se le informazioni per il primo blocco heap sono state copiate nel buffer o FALSE in caso contrario. Il valore di errore ERROR_NO_MORE_FILES viene restituito dalla funzione GetLastError se l'heap non è valido o vuoto.
Commenti
L'applicazione chiamante deve impostare il membro dwSize di HEAPENTRY32 sulle dimensioni, in byte, della struttura. Heap32First modifica dwSize sul numero di byte scritti nella struttura. Questo valore non sarà mai maggiore del valore iniziale di dwSize, ma potrebbe essere più piccolo. Se il valore è minore, non fare affidamento sui valori di tutti i membri i cui offset sono maggiori di questo valore.
Per accedere ai blocchi successivi dello stesso heap, usare la funzione 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
| 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 |