C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
_vunlock
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _vunlock function unlocks a virtual memory block. The
     argument <handle> points to a virtual memory block previously
     allocated through a call to _vmalloc or _vrealloc and locked
     through a call to _vlock.
 
     If multiple locks are held on the virtual memory block, the
     block's lock count is decremented by one. If the block's lock
     count goes to zero, the block can be swapped out by the virtual
     memory manager. The pointer returned by _vlock when the block was
     first locked then becomes invalid.
 
     The <dirty> flag indicates whether the block should be written out
     or discarded when swapping occurs. It can have one of the
     following values:
 
     Value         Meaning
 
     _VM_CLEAN     Discard contents of block when swapping occurs
 
     _VM_DIRTY     Write contents of block to auxiliary memory when
                   swapping occurs
 
     Return Value
 
     None.
                                    -♦-