Compartir a través de


Función RtlDestroyHeap (ntifs.h)

El RtlDestroyHeap rutina destruye el objeto de montón especificado. RtlDestroyHeap descommite y libera todas las páginas de un objeto de montón privado y invalida el identificador del montón.

Sintaxis

NTSYSAPI PVOID RtlDestroyHeap(
  [in] PVOID HeapHandle
);

Parámetros

[in] HeapHandle

Maneje el montón que se va a destruir. Este parámetro es un identificador de montón devuelto por RtlCreateHeap.

Valor devuelto

Si la llamada a RtlDestroyHeap se realiza correctamente, el valor devuelto es un puntero null.

Si se produce un error en la llamada a RtlDestroyHeap, el valor devuelto es un identificador del montón.

Observaciones

Los procesos pueden llamar a rtlDestroyHeap sin llamar primero a RtlFreeHeap para liberar memoria asignada desde el montón.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL < DISPATCH_LEVEL

Consulte también

rtlAllocateHeap

RtlCreateHeap

RtlFreeHeap