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 |