Funzione Heap32First (tlhelp32.h)

  • Articolo

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

Vedere anche

HEAPENTRY32

Elenchi heap ed heap walking

Heap32Next

Funzioni della Guida degli strumenti