_heapadd

Adds memory to the heap.

int _heapadd( void *memblock, size_t size );

Routine Required Header Optional Headers Compatibility
_heapadd <malloc.h> <errno.h> None

For additional compatibility information, see Compatibility in the Introduction.

Libraries

LIBC.LIB Single thread static library, retail version
LIBCMT.LIB Multithread static library, retail version
MSVCRT.LIB Import library for MSVCRT.DLL, retail version

Return Value

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

Parameters

memblock

Pointer to heap memory

size

Size in bytes of memory to add

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 Win32 platform and will immediately return –1 when called from an application of this type.

Memory Allocation Routines

See Also   free, _heapchk, _heapmin, _heapset, _heapwalk, malloc, realloc