_vfree

Description

Deallocates a virtual memory block.

#include <vmemory.h>

void __far _vfree( _vmhnd_t handle );

handle Handle to previously allocated virtual memory block  

Remarks

The _vfree function deallocates a virtual memory block. The argument handle points to a virtual memory block previously allocated through a call to _vmalloc or _vrealloc. The number of bytes freed is the number of bytes specified when the block was allocated (or reallocated, in the case of _vrealloc). The block must be unlocked before it is freed; use _vlockcnt to ensure that the block is unlocked. After the call, the freed block is available for reuse by the virtual heap.

Return Value

None.

Compatibility

Standards:None

16-Bit:DOS

32-Bit:None

See Also

_vlock, _vlockcnt, _vmalloc, _vrealloc, _vunlock

Example

See the example for _vmalloc.