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
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 |