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.
See Also free, _heapchk, _heapmin, _heapset, _heapwalk, malloc, realloc