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

 BLILIBLOD()
------------------------------------------------------------------------------
 Purpose:
 Dynamically load a CA-Clipper DLL library.

 Syntax:
 nuHandle = BLILIBLOD(cLibName)

 Parameters:
 cLibName  DLL library name

 Returns:
 A handle representing the DLL, or an error code less than 32 if the load
 failed.

 Description:
 This function is used to dynamically load a CA-Clipper DLL during program
 execution. This allows programs to be extended or updated `on the fly'
 without re-linking the main .EXE.

 The library handle is used to obtain handles for the functions in the DLL
 which are then used to call the functions.

 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                                                                    
 endif                                                                       

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