_bfreeseg

Description

Frees a specified based heap.

#include <malloc.h> Required only for function declarations  

int _bfreeseg( __segment seg );

seg Segment selected  

Remarks

The _bfreeseg function frees a based heap. The seg argument is a based heap returned by an earlier call to _bheapseg. It specifies the based heap to be freed.

The specified segment is freed completely regardless of whether the blocks it contains are free or allocated. After a _bfreeseg call, the seg value is invalid and should not be used.

Return Value

The _bfreeseg function returns 0 if successful and –1 in the case of an error.

Compatibility

Standards:None

16-Bit:DOS, QWIN, WIN, WIN DLL

32-Bit:None

See Also

_bheapseg, calloc functions, free functions, malloc functions, realloc functions

Example

See the example for _bheapseg.