Funzione HeapDestroy (heapapi.h)

  • Articolo

Elimina l'oggetto heap specificato.

HeapDestroy de-commits e rilascia tutte le pagine di un oggetto heap privato e invalida l'handle nell'heap.

Sintassi

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

Parametri

[in] hHeap

Handle per l'heap da distruggere. Questo handle viene restituito dalla funzione HeapCreate . Non usare l'handle per l'heap del processo restituito dalla funzione GetProcessHeap .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

I processi possono chiamare HeapDestroy senza prima chiamare la funzione HeapFree per liberare memoria allocata dall'heap.

Esempio

Enumerazione di un heap

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione heapapi.h (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Funzioni heap

HeapCreate

Funzioni di gestione della memoria

API Vertdll disponibili nelle enclave VBS