heapmin.md

title	description	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords
_heapmin	Learn more about: _heapmin	4/2/2020	_heapmin _o__heapmin	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-heap-l1-1-0.dll	DLLExport	apiref	_heapmin heapmin	heap memory minimizing heaps memory, releasing heaps, releasing unused memory _heapmin function heapmin function

_heapmin

Releases unused heap memory to the operating system.

Syntax

int _heapmin( void );

Return value

If successful, _heapmin returns 0; otherwise, the function returns -1 and sets errno to ENOSYS.

For more information about this and other return codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.

Remarks

The _heapmin function minimizes the heap by releasing unused heap memory to the operating system. If the operating system doesn't support _heapmin (for example, Windows 98), the function returns -1 and sets errno to ENOSYS.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header	Optional header
_heapmin	<malloc.h>	<errno.h>

For more compatibility information, see Compatibility.

See also

Memory allocation
free
_heapadd
_heapchk
_heapset
_heapwalk
malloc