Función HeapDestroy (heapapi.h)
Destruye el objeto de montón especificado.
HeapDestroy anula las confirmaciones y libera todas las páginas de un objeto de montón privado y invalida el identificador del montón.
Sintaxis
BOOL HeapDestroy(
[in] HANDLE hHeap
);
Parámetros
[in] hHeap
Identificador del montón que se va a destruir. La función HeapCreate devuelve este identificador. No use el identificador para el montón de procesos devuelto por la función GetProcessHeap .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Los procesos pueden llamar a HeapDestroy sin llamar primero a la función HeapFree para liberar memoria asignada desde el montón.
Ejemplos
Requisitos
Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | heapapi.h (incluya Windows.h) |
Library | Kernel32.lib |
Archivo DLL | Kernel32.dll |