`_heapadd`

Article
10/26/2022

Adds memory to the heap.

Important

This function is obsolete. Beginning in Visual Studio 2015, it is not available in the CRT.

Syntax

int _heapadd(
   void *memblock,
   size_t size
);

Parameters

memblock
Pointer to the heap memory.

size
Size of memory to add, in bytes.

Return value

If successful, _heapadd 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

Beginning with Visual C++ version 4.0, the underlying heap structure was moved to the C run-time libraries to support the new debugging features. As a result, _heapadd is no longer supported on any platform that is based on the Win32 API.

Requirements

Routine	Required header	Optional header
`_heapadd`	<malloc.h>	<errno.h>

For more compatibility information, see Compatibility in the Introduction.