BLILIBFRE()                   Free CA-Clipper DLL library
------------------------------------------------------------------------------

 Function : Free a CA-Clipper DLL library

 Syntax   : BLILIBFRE(nuHandle)

 Return   : None

 This function is used to free a dynamically loaded CA-Clipper DLL.once it is
 no longer needed.

 All function handles allocated for a library using BLIFUNHAN() become
 invalid once the library has been freed.

 Please see Chapter 5, 'DOS extended / Dual Mode programs', for more details
 on using DLLs.

 Example:

    libhan = BLILIBLOD (dllnme)      // Dynamically load the DLL
    if libhan > 32                // If it loaded successfully
       funhan = BLIFUNHAN (libhan,funnme)  // Get the handle
       if funhan > 0              // If the function was found
                      // Call function with (multiple) params
          funres = BLIFUNCAL (funpa1,funpa2,funhan)
                         // Note that function handle is LAST
       endif
       BLILIBFRE(libhan)          // Done so free the library
    endif