Función RtlDestroyHeap (ntifs.h)

  • Artículo

La rutina RtlDestroyHeap 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

Identificador del 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.

Comentarios

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Plataforma de destino Universal
Encabezado ntifs.h (incluya Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Consulte también

RtlAllocateHeap

RtlCreateHeap

RtlFreeHeap