Click above to get retro games delivered to your door ever month!

 BLILIBFRE()
------------------------------------------------------------------------------
 Purpose:
 Free a CA-Clipper DLL library.

 Syntax:
 BLILIBFRE(nuHandle)

 Parameters:
 nuHandle  DLL library handle

 Returns:
 None.

 Description:
 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.

 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                                                                       

 Notes:
 This function is provided mainly for consistency, since the memory
 and other resources used by a CA-Clipper .DLL cannot be actually freed until
 the applications finally exits. This is due to CA-Clipper's run time symbol
 table management.

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