Función RtlFreeHeap (ntifs.h)
La rutina RtlFreeHeap libera un bloque de memoria asignado desde un montón 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 el montón se creó mediante RtlCreateHeap.
| Bandera | 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. Este puntero lo devuelve rtlAllocateHeap.
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 lógico, que tiene un tamaño diferente al booleano.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de 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 |