Funzione HeapDestroy (heapapi.h)

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

Vedere anche

Funzioni heap

HeapCreate

Funzioni di gestione della memoria

API Vertdll disponibili nelle enclave VBS