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