Compartir a través de


Función RtlFreeHeap (ntifs.h)

La rutina RtlFreeHeap libera un bloque de memoria asignado desde un montón por RtlAllocateHeap.

Sintaxis

NTSYSAPI LOGICAL RtlFreeHeap(
  [in]           PVOID                 HeapHandle,
  [in, optional] ULONG                 Flags,
                 _Frees_ptr_opt_ PVOID BaseAddress
);

Parámetros

[in] HeapHandle

Identificador del montón cuyo bloque de memoria se va a liberar. Este parámetro es un identificador devuelto por RtlCreateHeap.

[in, optional] Flags

Conjunto de marcas que controla aspectos de liberar un bloque de memoria. Al especificar el siguiente valor, se invalida el valor correspondiente que se especificó en el parámetro Flags cuando RtlCreateHeap creó el montón.

Marca Significado
HEAP_NO_SERIALIZE La exclusión mutua no se usará cuando RtlFreeHeap acceda al montón.

BaseAddress

Puntero al bloque de memoria que se va a liberar. RtlAllocateHeap devuelve este puntero.

Valor devuelto

RtlFreeHeap devuelve TRUE si el bloque se liberó correctamente; FALSE en caso contrario.

Nota A partir de Windows 8 el valor devuelto se escribe como LOGICAL, que tiene un tamaño diferente al booleano.
 

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de 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

RtlDestroyHeap