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

Enumeración de un montón

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

Vea también

Funciones del montón

MontónCrear

Funciones de administración de memoria

API de Vertdll disponibles en enclaves de VBS