_heapadd

Article
06/05/2017

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at _heapadd.

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 _doserrno, errno, _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.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.